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IL SISTEMA 
OPERATIVO GEOS 


Introdimone 

Benvenuti alla programmazione in ambiente GEOS. Chi ha già familiarità con 
Taichitettura interna del computer Commodore 64 (C-64), troverà particolarmente 
semplice iniziare a programmare in ambiente GEOS. Chi invece non ha alcuna 
esperienza con il C-64, si accorgerà ben presto di compiere rapidi progressi, dal 
momento che il sistema operativo GEOS (GEOS) è in grado di sollevare il 
programmatore dai compiti più complicati e gravosi, lasciando che si concentri 
esclusivamente sul flusso delle operazioni fondamentali che l’applicazione deve 
svolgere. 

Questo volume dà per scontato che il lettore conoaa la progranunazione in 
linguaggio macchina, e abbia una buona familiarità con il computer C-64. In ogni caso 
è consigliabile tenere a portata di mano, per eventuali consultazioni, un manuale sul 
microprocessore 6510 e una copia della Commodore 64, Guida di riferimento per il 
programmatore (Conunodore Italiana). 

GEOS è l'acronimo di Graphic Enviromnent Operating System (Sistema Operativo 
ad Ambiente Grafico). Come suggerii» la sigla, GEOS adotta elementi grafici per 
semplificare l’interfaccia utente e il sistema operativo. La filosofia di GEOS consiste 
nel delegare al sistema stesso lo svolgimento della maggior parte delle operazioni più 
complesse di cui normalmente si fa carico TappUcazione; l’accesso al disco, la 
manipolazione dei bit dello schermo ad alta risoluzione, l’apertura e la chiusura dei 
menu, i box di dialogo, la gestione dei dispositivi di Input/Output (I/O) tramite i 
driver... 

I programmatori in grado di sfruttare appieno le opportunità offerte da GEOS, 
potranno realizzare le loro applicazioni con notevole risparmio di tempo e considerevo¬ 
le aumento di quahtà. Alcune sue caratteristiche, come la si^tziatura proporzionale 
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delle fonti caiatteie o il codice turbo per l’accesso al disco, dovrebbero essere inserite 
dal programmatore per ogni singola applicazione, con evidente spreco di tempo e di 
fatica. In ambiente GEOS, invece, queste risorse sono già disponibili, pronte per essere 
impiegate. Nel tempo necesseirio per realizzare una piccola routine di gestione dei 
caratteri in input, il programmatore che utilizza GEOS può dedicarsi alla costruzione 
di un’interfaccia utente completa e funzionale. 

La possibilità d’impiegare routine predefinite per i menu, le finestre o le altre 
caratteristiche grafiche di GEOS, consente di realizzare applicazioni semplici da usare 
e con una veste grafica di ottima qualità. GEOS è di notevole aiuto anche per l’utente, 
perché permette di controllare più o meno nello stesso modo - tramite menu e icone 
- applicazioni di tipo del tutto diverso. 

GEOS rende più vasti gli orizzonti applicativi del C-64. La presenza di un sistema 
turbo di accesso al disco, ad esempio, permette alle applicazioni di scambiare dati con 
la memoria di massa molto più rapidamente. Database e altre appUcazioni possono 
manipolare ragguardevoli quantità di informazioni con notevole risparmio di tempo. 

Il tempo che occorre per prendere confidenza con un nuovo sistema è un vero e 
proprio investimento. Ma fin dall’inizio, lo sforzo e le energie necessarie per imparare 
a orientarsi nell’ambiente di lavoro GEOS avranno come ricompensa una notevole 
rapidità di realizzazione, anche per procedure molto complesse. Gli obiettivi di GEOS 
sono semplici: maggiori possibilità per il programmatore, e maggiore semplicità per 
l’utente. Questo libro fa parte dello sforzo che abbiamo fatto per raggiungere questi 
obiettivi. 


Uniformiamo il linguaggio 

Prima di proseguire, è necessario spendere due peirole sulle notazioni che saranno 
utilizzate nel corso del manuale. All’interno di questo libro i riferimenti a costanti, 
locazioni di memoria, variabili e routine sono ottenuti mediante i loro nomi simbolici. 
Questa scelta ha lo scopo di facilitare la lettura e aiutare nella memorizzazione, dato 
che è certamente più facile ricordare parole anziché numeri esadecimali. L’istruzione 
jsr DoMenu illustra già nel nome una parte del suo significato, e si ricorda meglio di 
jsr $C151. Gli indirizzi e i valori associati ai nomi simboUci si trovano nelle appendici 
Costanti, VaiiabUi GEOS globali, e Routine. Si è stabilito convenzionalmente di 
scrivere i nomi delle costanti tutti in lettere maiuscole (FALSE, TRUE), i nomi deHe 
variabili con l’iniziale minuscola e ogni parola successiva con l’iniziale maiuscola 
(mouseXPos, mouseData); infine i nomi delle routine con l’iniziale di ogni parola 
maiuscola (DoMenu). Oltre a questi nomi simbolici, abbiamo usato nomi particolari 
anche per indicare alcune macro istruzioni del compilatore Assembly. Per esempio: 


LoadB 


variabile, valore 
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è una macro istruzione che indica; 

Ida #valore 

sta variabile 

In appendice è riportata la lista completa delle macro istruzioni utilizzate in questo 
testo. 


Le caratteristiche fondamentali 

Le applicazioni in ambiente GEOS hanno a disposizione le seguenti caratteristiche: 

• Menu a scomparsa 

• Icone 

• Spaziatura proporzionale delle fonti carattere 

• Routine di gestione delle stringhe di I/O che utilizzano la spaziatura 
proporzionale delle fonti carattere 

• Box di dialogo 

• Libreria completa di routine grafiche 

• Libreria completa di routine matematiche 

• Gestione multitasking alllnterno delle applicazioni 

• Elevata velocità d’accesso al disco 

• Sistema di suddivisione in pagine dei file 

• Set completo di interfacce di comunicazione con diverse stampanti 
e dispositivi di input 

GEOS è un sistema operativo dotato di tutte le qualità che caratterizzano i sistemi 
operativi grafici per computer di maggiori dimensioni, e la sua parte centrale è il 
Kernel. Si tratta di un programma residente in memoria e sempre in esecuzione. 
Contiene tutte le routine di gestione delle finestre, dei menu, delle icone, delle fonti 
carattere e di quant’altro GEOS è in grado di offrire. 

Facciamo un esempio per chiarire la differenza tra sistema operativo e interfaccia 
utente; deskTop non è p^e del Kernel, ma solo una delle possibili applicazioni, come 
geoPaint o geoWrite. È quindi possibile da parte dei programmatori realizzare 
applicazioni diverse per la gestione dei file, e lasciare deskTop nel cassetto. 

Programmando in ambiente GEOS, la maggior parte del lavoro consiste nella stesura 
di tavole di dati che definiscono le icone, i menu e le relative routine di servizio. 
Quando viene attivato un menu o un’icona, il Kernel chiama la routine corrispondente. 
Benché GEOS sia un sistema operativo sofisticato, il flusso delle operazioni primarie 
che esegue può essere descritto facilmente. 
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Qualsiasi input da parte dell’utente che dev’essere gestito dal Kernel di GEOS - 
come l’apertura di un menu, l’inserimento di un testo o lo spostamento del mouse - 
viene definito “evento” Il Kernel di GEOS è strutturato in modo da contenere tutte le 
routine necessarie per analizzare gli eventi. L’applicazione deve definire i menu, le 
icone e qualsiasi genere di evento tramite tavole di dati, nelle quali a ogni dato è 
associata una routine di servizio, da eseguire quando l’evento viene attivato 
dall’utente. Una volta che il Kernel di GEOS entra in possesso delle tavole di dati, è 
in grado di reagire agli eventi chiamando le routine di servizio eissociate. Per esempio, 
supponiamo che il programmatore decida di utilizzare tre icone, e per ognuna di esse 
crei una routine di servizio che esegue un particolare compito. Perché questa struttura 
diventi operativa, il Kernel di GEOS deve entrare in possesso di una tavola di dati nella 
quale siano definite le icone e le routine di servizio associate. Una volta che 
l’applicazione ha provveduto a questo, il controllo degli input che arrivano dall’utente 
diventa compito del Kernel che analizza gli eventi basandosi sulla tavola di dati e 
chiama(t) le corrispondenti routine di servizio. Quindi, a parte il lavoro d’inizializzazio- 
ne e l’esecuzione delle routine di servizio, il controllo delle operazioni in corso è affidato 
al Kernel di GEOS. Le stesse routine di servizio fanno uso delle caratteristiche di GEOS 
per svolgere le loro funzioni. 

In realtà l’applicazione potrebbe assumere il pieno controllo dell’hardware del 
computer, ma nella maggior parte dei casi conviene delegare questo lavoro al Kernel 
di GEOS. 

Ad esempio, invece di segnalare all’applicazione che il pulsante del mouse è stato 
premuto, il Kernel di GEOS potrebbe concludere, analizzando i diversi movimenti del 
mouse e la pressione del pulsante, che è stato attivato un evento come l’apertura di 
un menu. In questo caso alcune routine del Kernel, chiamate “esecutori”, analizzano 
la richiesta dell’utente e chiamano la routine di servizio associata all'evento. 

Nel caso dell’evento “menu” appena ipotizzato, il Kernel di GEOS inverte per un 
attimo la voce selezionata e chiama la routine corrispondente. Questo tipo di 
interazione è conosciuta come “programmazione a gestione di eventi” 

Un evento assume principalmente due forme; 

1) l’inizio di un’azione voluta dall’utente 

2) l’attivazione di un processo temporizzato definito dall’applicazione. 


(t) In questo manuale, a meno che non sia altrimenti specificato, ' chiamare una routine" significa eseguire 
l'istruzione assembly jsr (salta alla subroutine), e "ritornare" significa eseguire Tistruzione assembly rts 
(ritorna dalla subroutine). 
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Un processo temporizzato può essere, per esempio, una routine eseguita ogni 
secondo per aggiornare un orologio. Il programmatore non può limitarsi a realizzare la 
routine, ma deve anche stabilire con quale intervallo di tempo questa dev’essere 
eseguita. Il Kernel di GEOS prowederà poi a chiamarla periodicamente. 

Quando l’utente non opera nessuna azione in input al sistema, gli imici codici che 
il processore esegue sono quelli del Kernel di GEOS e i processi temporizzati attivi. Per 
la maggior parte, le applicazioni sono guidate solo dagli eventi. Il Kernel di GEOS è 
in grado di gestire il mouse in maniera autonoma, e quindi di capire se il pulsante è 
stato premuto sopra un’icona, un menu o qualche altra parte dello schermo. Il vettore 
otherPressVec contiene l’indirizzo della routine da chiamare nel caso che il pulsante 
venga premuto quando il mouse non si trova né su un menu, né su un’icona. Il vettore 
keyVector contiene l’indirizzo della routine da chiamare quando viene premuto un 
tasto della tastiera. In entrambi i casi è il Kernel che, tenendo sotto controllo 
l’hardware del computer, si accorge della pressione del pulsante in aree dello schermo 
non convenzionali (aree diverse da icone e menu) o della pressione di un tasto, e 
chiama le routine previste dal programmatore per gestire eventi non convenzionali. Ad 
esempio, la routine di gestione della pressione di un tasto della tastiera, potrebbe 
restituire un buffer contenente i caratteri battuti dall’utente. In un’applicazione come 
un editor di testi. Io schermo rappresenta parte di una pagina; premere il pulsante del 
mouse sullo schermo significa quindi selezionare una posizione sulla pagina. 11 punto 
selezionato diventa la nuova posizione sulla pagina dove introdurre un testo o un 
disegno. 

Quando l'utente preme il pulsante del mouse in una parte dello schermo diversa da 
un’icona o un menu, viene eseguita la routine il cui indirizzo è contenuto in 
OtherPressVec. La routine può accedere alle variabili mouseXPos e mouseYPos per 
determinare la posizione del mouse. Quando invece si preme un tasto, viene eseguita 
la routine il cui indirizzo è contenuto in keyVector, e l’applicazione può servirsi della 
routine di sistema GetNextChar per ricevere i caratteri digitati dall’utente. I vettori 
OtherPressVec e keyVector sono inizializzati a 0 per indicare che ai due eventi non è 
stata associata nessuna routine. La routine d’inizializzazione delle variabili contenuta 
in un’applicazione, dovrebbe aggiornare questi due vettori con gli indirizzi delle 
appropriate routine di servizio, oppure lasciarli a 0 se non ne è stata predisposta 
nessuna. 


La gestione della doppia pressione del pulsante 
del mouse attraverso otherPressVec 

Per doppia pressione del pulsante del mouse si intende la pressione del pulsante due 
volte in rapida successione. Nell’applicazione deskTop, per mandare in esecuzione un 
file programma bisogna premere il pulsante del mouse sopra la corrispondente icona 
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due volte in rapida successione. Descriveremo ora come l’applicazione registra una 
singola o una doppia pressione sul pulsante del mouse, quando il mouse non si trova 
su un'area convenzionale. Per quanto riguarda la doppia pressione sulle icone, 
l’argomento sarà discusso nel capitolo relativo alle icone. 

Il Kernel di GEOS ha a disposizione una variabile chiamata dblClickCount. Per 
gestire la doppia pressione del pulsante del mouse, si adotterà il seguente sistema. La 
prima volta che il mouse seleziona una parte dello schermo non convenzionale, viene 
chiamata la routine di servizio il cui indirizzo è contenuto in otherPressVec. Uno dei 
suoi compiti è quello di controllare il valore contenuto in dblClickCount, e se questo 
è 0, deve aggiornarlo con il contenuto della costante CLICK-COUNT. Quindi la routine 
esegue le operazioni previste per una singola pressione sul pulsante del mouse e infine 
ritorna. A ogni chiamata di interrupt, dblClikCount diminuisce di un’unità, se non è 
già a 0. Se il pulsante del mouse viene premuto un’altra volta prima che dblCUckCount 
arrivi a 0, la routine di servizio conclude che il pulsante del mouse è stato premuto due 
volte in rapida successione, e quindi esegue le operazioni associate a tale evento. Il 
tempo massimo ha le due pressioni, dopo il quale la routine di servizio non riconosce 
più una doppia pressione del pulsante del mouse, ma due singole pressioni separate, 
è determinato dalla costante CLICK-COUNT. 

Insieme ai vettori otherPressVec e keyVector, le routine di servizio dei menu e delle 
icone costituiscono gli strumenti primati per creare un’applicazione gestita da eventi. 
Per aumentare la flessibilità operativa, il Kernel di GEOS prevede anche alcune routine 
che non operano secondo la struttura a eventi. 


Il primo passo 

Il primo compito che un’applicazione deve svolgere quando viene mandata in 
esecuzione da deskTop, è quello di definire i menu, le icone e indicare le routine di 
servizio per gestire la pressione sul pulsante del mouse in aree non convenzionali e la 
pressione sui tasti della tastiera da parte dell’utente. Dovrebbe inoltre riconfigurare lo 
schermo, cancellandolo interamente e disegnando quanto è necessario a caratterizzare 
l’applicazione dal punto di vista grafico. 

Quando l’utente seleziona un file da deskTop per mandarlo in esecuzione, il Kernel 
di GEOS iniziallzza il sistema a uno stato di default, carica l’applicazione in memoria 
e la esegue con un jsr alla routine d’inizializzazione prevista dal programmatore. 
L’indirizzo è cóntenuto nel blocco File Header (blocco di testata del file) 
dell’applicazione, di cui parleremo più avanti. La routine che inizializza l’applicazione 
contiene le tavole di dati necessarie per definire i menu, le icone e altri eventi. Per 
trasferire le tavole di dati al controllo del Kernel, la routine deve chiamare apposite 
routine di sistema che possano leggere e attivare gli eventi. Oltre a questo, deve anche 
preoccuparsi di disegnare lo schermo secondo le esigenze dell’applicazione. Una volta 
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che la routine d’inizializzazione ha eseguito queste operazioni, restituisce il controllo 
al Kernel di GEOS. Il codice principale (main program loop) contenuto nel Kernel 
riprende il controllo e gestisce, grazie alle tavole di dati, la selezione dei menu, delle 
icone o di altri eventi da parte dell’utente. 

Quando viene selezionato un evento, il Kernel di GEOS chiama la routine associata, 
definita dall’applicazione. Come accade per la procedura d’inizializzazione, ogni 
routine di servizio restituisce il controllo al Kernel di GEOS nel momento in cui termina 
la propria esecuzione. 


Riepilogo 

Nei paragrafi precedenti sono stati illustrati molti argomenti importanti. Riassumia¬ 
moli brevemente: il Kernel di GEOS è un sistema operativo che condivide con 
l’applicazione la memoria del C-64, e viene eseguito in maniera cichca. Come tutti i 
sistemi operativi, controlla la maggior parte delle interazioni del sistema con 
l’hardware. Quando viene selezionato un evento, come la pressione di un tasto sulla 
tastiera o l’attivazione di un menu, il Kernel chiama la routine di servizio associata. 
Questa esegue il processo previsto dall’evento, di solito chiamando le routine di 
gestione greifica e di gestione testi installate nel Kernel di GEOS, e cedendo poi il 
controllo allo stesso GEOS. A questo punto il Kernel è pronto per analizzare un nuovo 
evento da parte dell’utente e chiamare la corrispondente routine di servizio. 

Consideriamo per esempio deskTop, una delle possibili applicazioni per la gestione 
dei file. Quando viene selezionata l’icona corrispondente a un file, deskTop comanda 
al Kernel di caricare in memoria l’applicazione e cederle il controllo. GEOS carica il file 
da disco, inizializza il sistema a uno stato di default ed esegue la routine 
d’inizializzazione della nuova applicazione che ha sostituito in memoria deskTop. 
Questa routine contiene le tavole di dati che definiscono gli eventi e chiama le routine 
del Kernel che trasformano gli “eventi definiti” in “eventi operativi". Essa deve anche 
riconfigureue lo schermo con una nuova veste grafica. 

In questo libro tutti gli argomenti citati sono ampiamente analizzati e corredati da 
sintetici esempi applicativi che utilizzano menu, icone e input di testi. Con le capacità 
di cui dispone GEOS, un’applicazione può giungere a una prima versione funzionante 
nel giro di una settimana. 

Per dare un’idea intuitiva di come lavora il Kernel di GEOS, nei prossimi paragrafi 
ne descriveremo l’intera struttura. 

La struttura del Kernel di GEOS 

Il Kernel di GEOS contiene due livelli di codice in costante esecuzione; MainLoop 
e InterruptMain. 
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MainLoop 

La routine MainLoop è un lungo codice che viene continuamente eseguito. Questa 
routine, a ogni ciclo, controlla se è stato attivato un evento dall’utente, ed 
eventualmente chiama la routine di servizio associata. Cioè controlla se sono arrivati 
dati in input.dall'utente e ne analizza il significato. 

La pressione sul pulsante del mouse può indicare: 

• la selezione di un’icona 

• l’apertura di un menu 

• la selezione della voce di un menu 

• l’attivazione di otherPressVec (se il mouse non si trova né su un menu 
né su un’icona). 

La pressione di un tasto della tastiera può indicare: 

• un testo in input dall’utente, analizzato dalla routine di servizio associata 
a keyVector 

• un testo per un box di dialogo, analizzato dalle routine del Kernel di GEOS. 

L’azzeramento di un lasso di tempo predefinito indica: 

• il sistema deve mandare in esecuzione il processo temporizzato associato. 

Dopo aver accertato la presenza di un input da parte dell’utente, MainLoop decide 
cosa fare. Nel caso di un menu le possibilità sono due: 

1 ) dev’essere aperto un sotto-menu. Se per esempio è stato selezionato il menu edit, 
le diverse voci del sotto-menu devono comparire sullo schermo 

2) dev’essere mandata in esecuzione la routine di servizio associata alla voce 
selezionata. Se per esempio è stata selezionata la voce cut, la routine di servizio 
deve trasferire una parte di testo. 

InterruptMaiii 

La routine InterruptMain contenuta nel Kernel di GEOS serve per gestire il 6510 IRQ 
interrupt che viene attivato 60 volte al secondo da un segnale di interrupt hardware 
presente all’interno del C-64. Questo segnale è generato dal clock di sistema. Ogni 
sessantesimo di secondo il micropro(»ssore (CPU 6510) interrompe l’esecuzione di 
MainLoop ed esegue la routine InterruptMain, la cui durata è molto inferiore a un 
sessantesimo di secondo. Il suo compito è solo quello di leggere la situazione hardware 
del sistema. Così anche nel caso che MainLoop impieghi un tempo molto più lungo 
del normale per completarsi (ad esempio nel caso che l’applicazione definisca routine 
di servizio particolarmente elaborate), InterruptMain mantiene l’interazione istanta¬ 
nea con l’hardware: la pressione di vm tasto o la richiesta di movimento del mouse da 
parte dell’utente sono eventi che in questo modo non vengono persi. 
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InterruptMain salva lo stato della CPU e gli pseudoregistri di cui parleremo fra poco, 
e interagisse con l'hardware del computer. Aggiorna un buffer interno con i caratteri 
provenienti dall’input dell’utente, decrementa il timer del sistema (vedere il capitolo 
dedicato agli interrupt) e i timer associati ai processi temporizzati, aggiorna la 
posizione del mouse sullo schermo e segnala se il pulsante è stato premuto. Se l’utente 
preme il pulsante del mouse, IntenuptMain imposta un flag il cui stato sarà poi 
controllato da MainLoop. MainLoop, in base alla posizione del mouse rispetto ai menu 
e alle icone definite dall’applicazione, decide come operare. Quindi la prima 
operazione della sequenza che caratterizza un evento inizia sempre in InterruptMain. 
Il mouse e la tastiera sono costantemente gestiti da InterruptMain, e quando avviene 
qualche cambiamento, è questa routine a impostare gli opportuni flag per segnalare 
e descrivere l’inizio dell’evento. Questi flag sono controllati da MainLoop almeno una 
volta per ogni ciclo. InterruptMain ripristina lo stato della CPU e degli pseudore0stri 
precedentemente salvati, e restituisce il controllo a MednLoop. MainLoop prende 
visione dei cambiamenti segnalati da InterruptMain e chiama le appropriate routine 
di servizio. Mentre InterruptMain ima volta iniziata non può essere interrotta, e quindi 
viene eseguita sempre per intero, MainLoop, come ogni altra routine definita 
dall’appUcazione, si interrompe ogni sessantesimo di secondo perché InterruptMain 
possa sempre tenere aggiornato lo stato dell’hardware. 

La maggior parte dei programmatori del C-64 sono abituati a creare versioni 
personali delle routine MainLoop e IntenuptMain per le loro applicazioni, ma è 
improbabile che tali routine siano così flessibili da poter essere utilizzate più di una 
volta. Utilizzando GEQS, invece, questo lavoro impegnativo e ripetitivo non dev’essere 
svolto. Il Kernel di GEQS è simile a un blocco di creta che attende di essere modellato 
dal progreimmatore. Le applicazioni GEQS compatibili sono costituite da una 
collezione di tavole per definire i dati necessari alla gestione degli eventi. Il flusso dei 
controlli sugli eventi è strutturato dal Kernel di GEOS. 

Ogni volta che una routine di servizio effettua un ritorno (rts), restituisce il controllo 
a MainLoop. Una routine di servizio può ridisegnare lo schermo, iniziahzzare 
nuovamente gli eventi, le icone, i menu e cosi via, e alla fine restituire tranquillamente 
il controllo a MainLoop che riprende il suo ciclo esattamente dal punto in cui era stato 
interrotto dalla chiamata della routine. MainLoop continua a girare come se niente 
fosse successo, ma l’ambiente dove si trova a operare può essere stato completamente 
riconfigurato. Per esempio, alla voce di un menu può essere associata una routine di 
servizio che cambia completamente l’ambiente con il quale l’utente interagiva, 
creandone uno del tutto nuovo. Di norma, una delle.prime operazioni eseguite da 
MainLoop consiste nel controllare se è stata selezionata un’icona. Ma se c’è un menu 
aperto questo controllo non viene effettuato, in quanto un menu e un’icona non 
possono essere selezionati contemporaneamente. Nel successivo ciclo di MainLoop, i 
nuovi menu, le nuove icone o altri eventi saranno a loro volta analizzati. 

Affidare a GEOS la maggior parte del lavoro più complicato e ripetitivo consente al 
programmatore di non reinventare per ogni applicazione un nuovo castello di routine. 
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Il Kernel di GEOS contiene le più svariate routine, e permette di creare applicazioni 
anche molto complesse, come geoWrite, geoPaint e deskTop, che utilizzano appieno 
le risorse messe a disposizione dal sistema. 11 prossimo paragrafo spiega come 
chiamare le routiné del Kernel. 


L’esecuzioiie delle routine del Kernel 

Questo paragrafo descrive la procedura che il programmatore deve seguire per 
chiamare le routine del Kernel di GEOS. La prima convenzione adottata nella creazione 
del Kernel di GEOS è stata quella di allocare alcime variabili in pjagina zero. In questo 
modo, infatti, le istruzioni del 6510 che indirizzano la pagina zero sono più rapide. 
Inoltre, per un’altra convenzione di base, le routine del Kernel di GEOS utilizzano 
queste variabili per accettare parametri, effettuare calcoli interni e restituire valori. 
Configurare le rottine con particolari variabili di input e di output dei parametri 
permette di controllare con estrema semplicità quali cambiamenti vengono introdotti 
in memoria da ogni routine. Inoltre queste convenzioni permettono ai programmatoti, 
e non solo alla Berkeley Softworks, di utilizare le routine del Kernel con relativa 
facilità. 

A questo proposito, 32 byte in pagina zero, allocati a partire dalla locazione $02, sono 
riservati per essere impiegati come pseudoregistri. Queste locazioni di memoria, divise 
in 16 word, sono numerate da rO a rl5.11 byte basso di ogni pseudoregistro può essere 
indicato sia come rN sia come rNL, dove N è il numero del registro. Il byte alto 
dev'essere indicato come rNH. 

Normalmente i parametri per le routine vengono passati attraverso gli pseudoregi¬ 
stri. Le routine utilizzano gli pseudoregistri per effettuare i loro calcoli interni. Anziché 
tentare subito di gestire centinaia di locazioni del Kernel di GEOS, il programmatore 
inizia manipolandone solo 16. Dal momento che InterruptMain, prima dì procedere alla 
propria esecuzione, salva lo stato di tutti gli pseudoregistii (da rO a rl5), può 
tranquillamente chiamare le routine del Kernel senza preoccuparsi che le stesse 
routine siano utilizzate in quel momento anche da MainLoop o daH’applicazione. In 
questo modo InterruptMain, che sfrutta le potenzialità offerte dalle routine di sistema 
senza intaccare lo svolgimento di MainLoop e delle appUcazioni, può diventare anche 
molto sofisticata. 

Gli pseudoregistri non sono l’unico modo per trasferire parametri alle routine del 
Kernel. Qualche volta, per migliorare la velocità, possono essere usati i registri a, x, y 
e anche il flag carry. Ma c’è ancora im altro modo per comunicare dati alle routine: la 
chiamata inline. Una chiamata inlìne risolve il problema delle routine che devono 
essere eseguite di frequente e che richiedono il trasferimento di numerosi parametri. 
Normalmente si dovrebbero utihzzare molte istruzicmi del 661G in linguaggio 
macchina per inizializzare gli pseudoregìstri con i dati da trasferire, ma questo 
procedimento, oltre che rallentare l’esecuzione della chiamata, spreca spazio di 
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memoria. Per ovviare airinconveniente, alcune routine che richiedono numerosi 
parametri possono essere chiamate anche utilizzando la chiamata inline. Mentre la 
chiamata normale di una routine prevede che i parametri siano trasferiti attraverso gli 
pseudoregistri, la versione inline fa in modo che la routine accetti i parametri 
prelevandoli dai byte che seguono immediatamente l’istruzione jsr di chiamata. Per 
esempio, la chiamata inline per disegnare un rettangolo è la seguente; 


jsr 

i-Rectangle 

jdisegna un rettangolo con la (natrice grafica corrente (la matrice 
;grafica corrente può' essere cambiata con la routine SetPattern) 

.byte 

e 

jlato superiore del rettangolo. 

Range possibile; 

0-199 

.byte 

199 

jlato inferiore del rettangolo. 

Range possibile; 

0-199 

.uord 

e 

jlato sinistro del rettangolo, 

Range possibile; 

0-319 

.word 

319 

jlato destro del rettangolo. Range possibile; 0- 

319 

Mentre la chiamata normale dovrebbe essere: 



LoedB 

r2L,0 

jlato superiore del rettangolo, 

Range possibile; 

0-199 

LoadB 

r2H,199 

jlato inferiore del rettangolo. 

Range possibile; 

0-199 

LoàdU 

r3,0 

jlato sinistro. Range possibile; 0-319 


LoadU 

r4,319 

jlato destro. Range possibile; 

0-319 


Jsr 

Rectangle 

jdisegna il rettangolo 




Quando viene chiamata una routine inline, questa preleva subito una word dallo 
stack. Di solito, in condizioni non inline, questa word individua l’indirizzo di ritorno 
che il processore memorizza nel registro .program counter (PC) quando incontra 
l’istruzione rts al termine della routine. Invece, in condizioni inline, la word individua 
l’inizio del gruppo di parametri che seguono immediatamente la chiamata. La routine 
inline preleva il numero di byte corrispondente al numero di parametri di cui ha 
bisogno e aggiorna una word con l’indirizzo corrispondente alla prima locazione di 
memoria dopo il gruppo di dati. La word viene reinserita nello stack per aggiornare 
l’indirizzo di ritorno della routine, e solo dopo queste operazioni la routine inizia a 
svolgere i compiti per cui è stata programmata. 

L’impiego della chiamata inline è consigliato nel caso di routine che devono essere 
chiamate di frequente e che necessitano di numerosi parametri di valore fisso. Per 
esempio, per cancellare una parte dello schermo, conviene effettuare una chiamata 
inline a L-Rectangle anziché una chiamata normale a Rectangle qualora i parametri di 
input non debbano varieire. In questo modo si utilizzano meno byte che per una 
chiamata normale, perché quest’ultima dovrebbe essere preceduta daU’aggiornamen- 
to degli pseudoregistri tramite le istruzioni in linguaggio macchina del 6510. Per 
essere precisi, la macro istruzione LoadW r3,0 occupa otto byte di memoria mentre la 
direttiva .word 0 ne occupa solo due. I nomi delle routine inline iniziano sempre con 
i-, come i_Rect£ingle. 
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Sono le routine del Kernel di GEOS che utilizzano numerosi parametri di input hanno 
a disposizione anche la chiamata inline. Le routine utilizzate meno frequentemente o 
quelle che utilizzano uno o due parametri, prevedono solo la chiamata normale. Anche 
il programmatore può facilmente installare, aU’interno delle sue applicazioni, alcune 
routine inline. 

In questo paragrafo abbiamo descritto in che modo le applicazioni possono effettuare 
una chiamata alle routine del Kernel, e come quest’ultimo utilizza le routine di servizio 
delle applicazioni. Abbiamo descritto quali sono i compiti di MainLoop e Interrupt- 
Main nel Kernel di GEOS. Nei prossimi paragrafi spiegheremo in che modo 
un’applicazione può inserire i propri codici aH’interno di InterruptMain e MainLoop. 
Di solito questa procedura è da sconsigliare, ma in alcune circostanze diventa 
necessaria per gestire particolari dispositivi hardware esterni. Se si dovesse incontrare 
questa necessità, l’applicazione può aggiornare alcuni vettori previsti nella RAM di 
sistema, che permettono di aggiungere codici particolari a InterruptMain o a 
MainLoop. Una buona regola è evitare di alterare i codici di MainLoop o InterruptMain. 
Infatti una routine di interrupt in un’applicazione può incontrare qualche difficoltà nel 
mantenere il sincronismo fra MainLoop e InterruptMain. 


Codice non strutturato in eventi 

La maggior parte delle appUcazioni non ha bisogno di ricorrere a codici non gestiti 
da eventi. Questi codici devono essere eseguiti a ogni chiamata di interrupt o a ogni 
ciclo di MainLoop, indipendentemente dalle azioni dell’utente, e non possono essere 
predisposti come processi temporizzati. L’unico motivo per cui il programmatore può 
avere la necessità di crearli, è la gestione di speciali dispositivi hardware. Alterando 
particolari vettori di sistema opportunamente predisposti, il programmatore può 
richiedere al Kernel di GEOS di controllare alcune routine non gestite da eventi. I 
vettori per aggiungere codici a InterruptMain o a MainLoop sono intTopVector, 
intBotVector, e appMain. Se un’applicazione esige che la sua routine di interrupt sia 
eseguita prima dei codici di InterruptMain, può alterare l’indirizzo contenuto in 
intTopVector(t). In questo caso viene eseguito un salto indiretto attraverso 
intTopVector, che normalmente contiene l’indirizzo di InterruptMain. 

Aggiornando questo vettore con l’indirizzo di una routine personalizzata, questa 
viene eseguita prima di ogni altra cosa a ogni interrupt. La fine della routine di 
interrupt dell’applicazione dev’essere costituita dall’istruzione “jmp InterruptMain” 
Allo stesso modo, per mandare in esecuzione un codice addizionale alla fine della 
routine InterruptMain, si deve alterare intBotVector. Alla fine dei codici di 


(t) Gli indiiizzì reali di memoria delle variabili e delle routine, e i valori delle costanti citate nel testo, sono 
riportati in appendice. 
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InterruptMain, il Kernel di GEOS effettua una chiamata alla subroutine indirizzata dal 
vettore intBotVector, a meno che questo non sia zero (che è il suo valore di default). 
Qualsiasi routine eseguita attraverso intBotVector deve terminare con TisUruzione rts, 
e non rti. 

La mag0or parte della programmazione può essere compiuta utilizzando la gestione 
a eventi. È comunque possibile aggiimgere routine addizionali a MainLoop, 
aggiornando il vettore appMain con l'indirizzo della routine da chiamare. Durante ogni 
ciclo di Maìnloop viene eseguito im salto indiretto attraverso appMain, a meno che 
questo non sia zero (che è il suo valore di default). Un rts alla fine della routine 
chiamata attraverso appMain, restituisce il controllo alla routine MainLoop del Kernel 
di GEOS. 

Procedura consigliata per la stesura 
di un'applicazione in ambiente GEOS 

Siamo ora in grado di analizzare i passi necessari per programmare in ambiente 
GEOS. 

1) Scelta degli eventi: i menu, le icone o gii altri eventi che l’appUcazione deve 
definire. Un tipo speciale di eventi è costituito dai processi temporizzati che 
saranno descritti nei prossimi capitoli. 

2) DeGnMone degli eventi: aggiornamento dei vettori e preparazione delle tavole 
di dati che definiscono gli eventi (per esempio la struttura di un menu si realizza 
definendo una semplice tavola di dati associata). 

3) Stesura delle routine: creazione delle routine di servizio eseguite da MainLoop 
per reagire agli eventi previsti dal programmatore. 

Per meglio comprendere l’importanza dei passi che abbiamo qui elencato, vediamo 
cosa significa programmare in ambiente GEOS. GEOS permette di trasformare un’idea 
in un’applicazione funzionante in brevissimo tempo, in quanto aiuta il programmatore 
a suddividere il lavoro in tanti piccoli moduli contenenti tavole di dati e le relative 
routine di servizio associate agli eventi. Illustriamo ora brevemente la configurazione 
hardvrare creata da GEOS: il modo grafico utilizzato, la sua allocazione in memoria e 
come sono impostati i registri di selezione dei banchi di memoria. 

È possibile programmare in ambiente GEOS senza conoscere niente dei modi grafici 
e della selezione dei banchi di memoria. Chi è nuovo alla struttura hardware del C-64 
non deve preoccuparsi se i prossimi paragrafi gli sembreranno di difficile comprensio¬ 
ne. Si dà comunque per contato che il lettore abbia consultato il volume Commodore 
64, Guida di riferimento per il programmatore. È improbabile che il progranunatore 
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abbia necessità di cambiare la me^pa di memoria (Memory Map) standard di GEOS. 
Può comunque accadere che l’applicazione debba accedere alla ROM del Kernel di cui 
la Commodore ha dotato il C-64, oppure a una routine di calcolo in virgola mobile nella 
ROM del Basic, e successivamente ripristinare la configurazione standard per operare 
normalmente. Il resto di questo capitolo è dedicato all’analisi della struttura hardware 
configurata da GEOS. Questo significa illustrare il modo grafico prescelto, le aree di 
memoria occupate dal Kernel, le differenze tra le varie versioni del Kernel residenti in 
memoria, l’impostazione dei registri hardware del sistema e infine il metodo per 
alterare la configurazione della memoria e accedere alle routine contenute nella ROM 
del Kernel, o del Basic, del C-64. 


Modo bit-map in alta risoluzione 

GEOS utilizza il modo grafico bit-map del C-64 con una risoluzione di 320 x 200 pixel. 
In questo modo sono occupati 8000 byte (20Ò linee di scansione da 40 byte per linea) 
per gestire lo schermo in alta risoluzione. 

Per facilitare la gestione dello schermo grafico in ambiente GEOS, viene allocato in 
memoria un buffer di altri 8000 byte, il buffer di schermo, la cui funzione è quella di 
conservare una copia dello schermo grafico corrente. Tramite opportune routine, le 
immagini (parti di schermo) memorizzate nel buffer vengono copiate sullo schermo, 
e viceversa. Avere una copia dello schermo grafico è uno stratagemma molto utile per 
gestire menu o box di dialogo sullo schermo corrente. In pratica le parti di schermo 
che vengono cancellate dall’apertura di un menu o dall’apparizione di im box di 
dialogo sono preventivamente salvate nel buffer. I^r ripristinare sullo schermo 
l’immagine sottostante, per esempio alla chiusura dì un>menu, le routine di gestione 
dei menu e dei box di dialogo, indipendentemente dalTapplicazione, copiano sullo 
schermo i dati salvati nel buffer. In questo modo TappUcazione non deve preoccuparsi 
di ripristinare l’immagine coperta da un menu, operazione che in certi casi potrebbe 
risultare impossibile. 

Le routine di recupero delle immagini nascoste dai menu e dai box di dialogo, 
possono essere utilizzate anche dalle routine di servizio delle applicazioni. L’applica¬ 
zione geoPaint utilizza queste routine per l’opzione undo, la quale ripristina la pagina 
grafica eliminando gli effetti dell’ultima operazione. Le routine del Kernel di GEOS 
realizzate per gestire le copie conservate nel buffer di schermo, includono 
RecoverAllMenus, RecoverLine, RecoverMenu e RecoverRectangle. Queste routine 
sono illustrate nei capitoli dedicati alla grafica e ai menu. L’impiego del buffer di 
schermo, da parte del Kernel di GEOS, può essere disabilitato dall’applicazione, se 
quest’ultima desidera utilizzare l’area di memoria da esso occupata per usi diversi. 
Questo argomento è analizzato nel capitolo "GEOS e la grafica”. 
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La mappa di memoria 

La mappa di memoria del Kernel di GEOS indica com'è organizzata la memoria del 
C-64 e quali sono gli spazi liberi per le applicazioni. Le applicazioni hanno a 
disposizione circa 22K di memoria, dall’indirizzo $0400 all’indirizzo $5FFF. Con 
speciali accorgimenti, le applicazioni possono estendere tale spazio utilizzando anche 
il buffer di schermo. Questa operazione libera altri 8K, aumentando lo spazio 
disponibile a 30K. È una quantità di meihoria che può apparire limitata per la stesura 
di applicazioni complesse, ma è importante non dimenticare che i codici di gestione 
dei menu, delle icone, dei box di dialogo, dei vari buffer e del disco sono già presenti 
nel Kernel di GEOS. Questo significa diminuire considerevolmente il tempo e gli sforzi 
necessari ai programmatori per realizzare le applicazioni, e che 22K o 30K di memoria 
sono più che sufficienti. Inoltre l’elevata velocità oporativa delle routine di accesso al 
disco contenute nel Kernel di GEOS pormette di interscambiare con grande rapidità 
moduli di programma memorizzati sul disco. In questo modo l’applicazione, a seconda 
del tipo di evento, può velocemente caricare da disco il modulo di programma 
corrispondente, ed eseguirlo. Grazie a questa gestione in overlay, le applicazioni in 
ambiente GEOS possono anche occupare uno sp)azio maggiore della memoria a loro 
disponibile, e quindi diventare molto complesse. Per facilitare la gestione dei moduli 
di programma da parte del modulo principale dell’applicazione, è stata ideata e 
realizzata la struttura dei file VLIR. A questo argomento, por l’importanza che riveste, 
eibbieimo dedicato un intero capitolo. 

Per un programmatore, generalmente, le uniche informazioni da conoscere sulla 
mappa di memoria del Kernel di GEOS sono la memoria disponibile por le applicazioni 
e le locazioni disponibili per memorizzare i dati. 

La RAM disponibile por i dati (oltre allo spazio riservato all’applicazione, che il 
programmatore potrebbe sfruttare anche por i dati), è suddivisa in tre aree separate. 
La prima consiste negli pseudoregistri rO - tl5. Per utilizzarli, bisogna ricordare che 
eliche le routine del Kernel ne fanno uso por i loro calcoli interni. Saranno date ampie 
informazioni sugli pseudoregistri utilizzati da ogni routine del Kernel di GEOS. La 
seconda area è costituita da 4 byte dalla locazione $00FB alla $00FE in pogina zero, 
che non sono utilizzati né dal Basic, né dal Kernel del C-64. In ambiente GEOS sono 
chiamati pseudoregistri aO e al. Impiegando gli pseudoregistri, che sono tutti allocati 
in pagina zero, il programmatore e le routine del Kernel di GEOS risparmiano byte di 
memoria. Infatti, l’indirizzamento in pagina zero richiede un solo byte, oltre al codice 
dell’istruzione. Tale rispiarmio di memoria diventa importante, por esempio, quando 
si devono aggiornare numerosi pseudoregistri con i parametri da passare a una 
routine. 

C’è un’altra regione di memoria utilizzabile dall’applicazione por i suoi dati, che si 
estende dalla locazione $70 alla $7F. Queste locazioni di memoria sono gli 
pseudoregistri a2 - a9. Infine è disponibile all’applicazione lo spazio di memoria 
compreso fra l’indirizzo $7F40 e l’indirizzo $7FFF, anche se si tratta di aree di memoria 
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non contenute in pagina zero. Per esempio, l’applicazione deskTop utilizza il vettore 
di byte da $7F40 a $7FFF per memorizzare sequenzialmente i gruppi di dati che 
caratterizzano ogni icona. Per un panorama completo dello spazio di memoria 
disponibile all’applicazione, consultare la Memory Map in appendice, o la seguente 
tavola riassuntiva. 



La niHppa di memoria di GEOS 

Numero byte 

Range di bidirtzzo 

Descrizione 

1 

10000 

Re 9 Ìstro direzione dati del 6510 

1 

$0001 

Registro di I/O del 6510 

110 

$0002-$006F 

Pagina zero per GEOS e per le applicazioni 

16 

$0070-$007F 

Pagina zero solo per le applicazioni 

123 

$0080-$00Ffì 

Pagina zero per le routine del Kernel 
e del Basic del C-64 

4 

$00FB-$00FE 

Pagina zero solo per le applicazioni 

1 

$00FF 

Usata dal Kernel e dal Basic del C-64 

256 

$0100-$01FF 

Stack del 6510 

512 

$0200-$03FF 

RflH usata dal Kernel del C-64 

23552 

$0400-$5FFF 

RRH per le applicazioni e i dati 

8000 

$6000-$7F3F 

RAM per il buffer di scherao 

192 

$7F40-$7FFF 

RRH per i dati delle applicazioni 

2560 

$8000-$89FF 

Buffer di gestione del disco e variabili di GEOS 

512 

$8fi00-$8BFF 

Dati degli sprite 

1000 

$8C00-$8FE7 

natrice dei colori dello scherao 

16 

$8FE8-$8FF7 

RftH per GEOS 

8 

$8FF8-$8FFF 

Puntatori agli sprite 

4096 

$9000-t9FFF 

Codici del Kernel di GEOS 

8000 

$fl000-$BF3F 

Scherao in Hi-Res di GEOS o ROH del Basic 

192 

$BF40-IBFFF 

Tavole di dati di GEOS 

4096 

$C000-$CFFF 

4K di codice del Kernel di GEOS seapre residente 

4096 

$D000-$DFFF 

4K di codice del Kernel di GEOS o 4K di spazio 
per I/O del C-64 

7808 

$E000-$FE7F 

8K di codice del Kernel di GEOS o 8K di ROH 
del Kernel del C-64 

378 

$FE80-$FFF9 

Driver di input 

6 

$FFFfl-$FFFF 

6510 NHI, IRQ, e vettori di reset 
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11 controllo degli I/O, dei disegni sullo schermo e degli inteirupt, può e dev’essere 
effettuato dal Kernel di GEOS. Le routine del Kernel sono semplici da usare e, che 
l’appUcazione le impieghi o no, occupano spazio di memoria. 1 prossimi due paragrafi 
illustrano nei dettagli la configurazione hardware utilizzata da GEOS e possono essere 
tralasciati dalla maggior parte dei lettori. Sono stati inclusi nel libro per o^ire ai 
programmatori la possibilità di gestire dispositivi di I/O che il Kernel di GEOS non 
supporta (per ora), e la possibilità di usare il Basic al posto del linguaggio macchina. 


La versione del Kernel 

Airinterno del Kernel di GEOS ci sono diversi byte utilizzati per identificare la 
versione di GEOS conentemente in memoria. Alla locazione $0006 si trova la stringa 
“GEOS BOOT”. Questa stringa può essere utilizzata per determinare se l’applicazione 
è stata caricata da GEOS. I programmatori che non utilizzano le routine del Kernel di 
GEOS nelle loro applicazioni possono scrivere in tutta la RAM, tranne che nel vettore 
di dati che va da $0000 a $O07F. Questo vettore contiene i codici che le applicazioni 
devono usare per riattivare GEOS; può essere spostato in qualunque zona, ma per 
mandarlo in esecuzione si deve riportarlo a $0000. 

Immediatamente dopo la stringa “GEOS BOOT” ci sono due nibble (che insieme 
formano un byte) contenenti il numero della versione. Normalmente questo byte 
contiene $12 o $13 per indicare rispettivamente la versione 1.2 o la 1.3. Nel Kernel di 
GEOS versione 1.3 sono presenti informazioni aggiuntive subito dopo il byte della 
versione corrente. Il primo byte indica la lingua della versione. Il secondo byte non 
viene impiegato, mentre il terzo byte, sysFlgCopy, viene impiegato da GEOS VI.3 per 
memorizzare lo stato del sistema quando viene riceduto il controllo al Basic. I cinque 
byte seguenti sono riservati per future espansioni e sono attualmente a $00. Al 
momento in cui scriviamo, sono disponibili le versioni in inglese, tedesco, francese, 
olandese e italiano, mentre in futuro sono previste anche versioni in lingua svedese, 
spagnola e portoghese. 

Questo vettore viene illustrato nella tavola della pagina successiva. 
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BootGEOS! 

jmp o-BootGEOS jSalta al vettore di rientro in GEOS. Se la routine o_BootGE0S 
jin future versioni si troverà' a un diverso indirizzo, basterà' 
joperare un salto a BootGEOS (JCOOO) per risolvere il problema, 
jInfatti nel passaggio da una versione a un'altra lo spazio da 
j$C000 a $C07F viene conservato, e saltando a $C000 si ottiene 
jil caricamento di GEOS 

ResetHandlei 

jmp o_ResetHandle jQuesto e' un vettore di salto utilizzato da GEOS durante la 
;procedura di Cold Start. Le applicazioni non possono 
jchiamare questa routine 

BootFileName: 

.byte “GEOS BOOT” jL'indirizzo e' $C006. Questa stringa può' essere 

;utilizzata per determinare se un'applicazione e' stata 
jcaricata da GEOS. Si può' verificarne la presenza anche con 
;un'applicazione in Basici in caso positivo si può' mandare in 
jesecuzione l'istruzione sys (49152) per ricaricare GEOS 

Wersioni 

.byte $13 jQuesto byte contiene il numero della versione. 

jLe versioni correnti sono la 1.2 e la 1.3 

jQuanto segue e' presente solo nella versione 1.3 

Nationalityi 

.byte X ;Byte che indica la lingua usata dal sistema: 

)INGLESE = 0 

; TEDESCO = 1 

; FRANCESE = 2 

; OLANDESE = 3 

)ITALIANO = 4 

iSVEDESE = 5 (non installata) 

^SPAGNOLO = 6 (non installata) 

;P0RT0GHESE = 7 (non installata) 

futureUsel: 

.byte 0 jlC011 Riservato per impieghi futuri 

SEGUE 
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SEGUE 


sysFlgCopy; 

.byte 0 

jlC012 Questo flag viene impiegato solo da GEOS VI.3 quando 
je' presente un'espansione RAM 

;Bit 7: se e' impostato a 1, MoveData in GEOS impiega l'espan- 
;sione RAM per accelerare gli spostamenti dei blocchi di dati 
;Bit Si se e' impostato a 1, $08300-$0B8FF mantiene i driver 
jper i drive dall'A al C 

jBit 5: se e' impostato a 1, saltando a IC00@ si produce 

;la riattivazione del sistema dall'espansione RAM (il disco GEOS 

;di caricamento non dev'essere necessariamente nel drive) 

•byte 8 

;Riservato per usi futuri 

.byte 8 

;Riservato per usi futuri 

.byte 0 

;Riservato per usi futuri 

.byte 0 

jRiservato per usi futuri 

.byte 0 

jRiservato per usi futuri 


Configurazioni dei banchi di memoria e del sistema 

La maggior parte del Kernel di GEOS si trova in memoria da $BF40 in poi. Occupa 
uno spazio nella RAM normalmente utilizzato per altri scopi. Lo spazio da $D000 a 
$DFFF è impiegato per gli I/O, ma il C-64 offre la possibilità di sovrapporgli della RAM 
utilizzabile per altri scopi. Nello stesso modo le ROM del Basic e del Kernel del C-64 
possono essere sovrapposte da aree di 8K di RAM libera. Durante operazioni normali, 
tutti i banchi di memoria in cui sono contenuti i codici del Kernel di GEOS sono 
sovrapposti alla ROM del Basic, alla ROM del Kernel e allo spazio di I/O del C-64. Tutti 
gli I/O sono gestiti dal Kernel di GEOS che si preoccupa di selezionare i banchi di 
memoria durante l’esecuzione delle routine di interrupt o di accesso al disco. 

La selezione dei banchi viene effettuata tramite il registro allocato a $0001 e da due 
linee provenienti dalla porta predisposta per l’inserimento di una cartuccia 
d’espansione. Dal momento che il Kernel di GEOS non utilizza alcuna cartuccia, le 
resistenze di pulì up delle due linee interne al C-64 impostano lo stato delle linee ad 
“alto”. Il registro che controlla la memoria di schermo e la memoria carattere è $D018. 

Se l’applicazione si trova nella necessità di accedere allo spazio di I/O senza poter 
utilizzare le apposite routine del Kernel di GEOS, o vuole accedere alla ROM del Kernel 
0 del Basic del C-64, deve eseguire le due routine del Kernel di GEOS InitForlO e 
DoneWithlO. Queste routine, rispettivamente, salvano e ripristinano la configurazione 
della mappa di memoria utilizzata da GEOS, e controllano gli interrupt e gli sprite a 
seconda delle necessità. 
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Segue una tavola che illustra come normalmente GEOS aggiorna i registri che 
configurano il sistema. 


Impostazione dei registri di controllo effettuata da GEOS 


Funzione di 
controiio 

Indirizzo 

Valore 

Descrizione 

Selezione banchi 

10001 

XXXX000X 

Seleziona quale banco di ROM deve 
apparire nello spazio indirizzabile, 

GEOS disabilita il Kernel del C-64, 
lo spazio di I/O e la ROM del Basic 

Selezione del 

banco visto 

dal Vie 

tDD00 

XXXXXX01 

Seleziona quale area da 16K e' vista 
dal Vie. GEOS seleziona il banco 2 

da $8000 a $BFFF 

Memoria di schermo 

IO01S 

001IXXXX 

Determina la locazione della memoria 

di schermo, GEOS seleziona l'area 

di memoria che va da $8000 a $8FE7 

Memoria carattere 

tD018 

XXXX010X 

Seleziona dove appare la memoria 
carattere vista dal VIO nel banco 

selezionato, GEOS la alloca da $fl000 

a $BF3F 


Costanti per selezionare i banchi 


IO-IN 

= $35 

j60K 

RfiM, 4K di 

spazio I/O attivati 

RflM-64K 

= $30 

;64K 

RfiM di sistema 

KRNL-BfìS-IO-IN 

= $37 

;R0M 

del Kernel 

e del Basic attivate 

KRNL-IO-IN 

= $36 

;R0M 

del Kernel 

e spazio 1/0 attivati 
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Direttive del compilatore Assembly 

L’ambiente di sviluppo che abbiamo utilizzato alla Berkeley Softworks può essere 
diverso dal vostro. Il compilatore che adoperiamo è di nostra erezione. Nelle semplici 
applicazioni che presentiamo in c[uesto volume riportiamo i listati generati dal nostro 
compilatore, aH’interno dei quali compaiono le nostre direttive e macro istruzioni. 
Abbiamo cercato di utilizzare le macro istruzioni il meno possibile, per non ostacolare 
la comprensione dei listati. In appendice ne è riportata l’intera documentazione. Segue 
una tavola che illustra le direttive del nostro compilatore. 


Direttive del compilatore utilizzate negli esempi 


Tipo Pseudocodice 

Argomento 

Descrizione 

direttiva 



Imposta l'indirizzo: 



.psect 

[VfiLORE] 

VALORE viene utilizzato come indirizzo. 

Il codice che segue e' compilato a 
partire dall'indirizzo VALORE. Se VALORE 
non e' specificato, la compilazione 
genera un codice che il linker può' 
rilocare 

.ramsect 

[VALORE] 

Stesso significato di .psect, ma per le 
variabili 

Label : 



NOUE: 


Assegna l'indirizzo corrente a NOME. 

I due punti sono opzionali se la label 
non viene spostata dal margine 

Costanti : 



NOME 

=[carattere]VRLORE 

Eguaglia NOME a VALORE, dove VALORE e' 
un numero decimale se non e' preceduto 
da un carattere; un numero esadecimale 
e' sempre preceduto dal simbolo 1, men¬ 
tre un numero binario e' preceduto da X 

Dati : 



.byte 

vali, val2... 

Memorizza vali, val2... in byte 
sequenziali 



SEGUE 
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SEGUE 

.word vali, val2.. 

RRUì 

.block VALORE 

Compilazione condizionale: 

.if espressione 

.elif 

.else 

.endif 


Memorizza vali, val2... in word 
sequenziali da 16 bit 

Alloca il VALORE di byte nella memoria 
Normalmente segue una label 

Se “espressione'' e' vera, compila 
il codice incluso 

Termina una parte di codice iniziata con 

if e ne inizia un'altra 

Termina una parte di codice iniziata con 

if e ne inizia un'altra alternativa alla 

precedente 

Termina qualunque struttura aperta 


La prima realizzazione 

Nel prossimo capitolo si inizia a descrivere passo per passo la programmazione in 
ambiente GEOS. Il primo esempio è una piccola applicazione che contiene solo una 
routine d’inizializzazione per pulire lo schermo e definire alcune icone. Ogni icona, 
quando è selezionata, chiama una routine di servizio che cancella lo schermo e 
definisce una struttura di menu. Cercheremo così di descrivere come devono essere 
definite le icone e i menu in ambiente GEOS. 

Dopo questo esempio applicativo, spiegheremo come realizzare l’applicazione, 
memorizzarla su disco ed eseguirla con GEOS. 

Nei capitoli successivi parleremo della grafica, dei testi, dei file, dei box di dialogo, 
degli interrupt, della stampa e degli sprite. Ogni capitolo contiene una spiegazione 
generale, seguita da un esempio, e quindi una completa descrizione delle routine del 
Kernel inerenti all'argomento illustrato. 

Più avanti spiegheremo come realizzare un driver di input e uno di stampa, 
utilizzando la libreria di routine installata nel Kernel di GEOS. Finché non si raggiunge 
una completa familiarità con l’ambiente di GEOS, è spesso utile servirsi di routine di 
servizio fittizie che eseguono solo un rts. In questo modo la struttura dei menu e delle 
icone può essere verificata prima che vengano aggiunte le routine di servizio associate. 
Dopo che gli eventi sono stati definiti, i menu si aprono e le icone si invertono 
momentaneamente, anche se le routine di servizio non eseguono assolutamente 
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niente. In questo modo il programmatore può collaudare la struttura generale 
dell'applicazione, prima di addentrarsi nella stesura dei codici di servizio degli eventi. 


La compatibilità delie applicazioni con GEOS 128 

In linea di massima, le applicazioni create per GEOS 64 che sfruttano la jump table 
a $C100 e soprattutto delegano al sistema operativo lo svolgimento di tutte le funzioni 
di basso livello, non dovrebbero incontrare problemi di compatibilità se vengono 
mandate in esecuzione con GEOS 128. La compatibilità è possibile dal momento che 
GEOS 128 è un ampliamento di GEOS 64, e come tale ne conserva interamente le 
caratteristiche. Le variabili globali di sistema possedute sia da GEOS 128 sia da GEOS 
64 non presentano alcuna differenza; tutte le routine del Kernel svolgono gli stessi 
compiti in entrambi i sistemi, con l’unica differenza che GEOS 128 ne aggiunge diverse 
altre. In particolare, GEOS 128 si avvicina molto alla struttura di GEOS VI.3, dal 
momento che è in grado di gestire le espansioni RAM nello stesso modo. Vedremo 
comunque quali potrebbero essere le ragioni di eventuali incompatibilità e come porvi 
rimedio. Per adesso è sufficiente sottolineare che in linea di massima tutte le 
applicazioni realizzate seguendo le direttive di questo manuale, dovrebbero funzionare 
correttamente anche con GEOS 128 nel modo a 40 colonne. 

Nel momento in cui scriviamo, non sono state ancora realizzate applicazioni per 
GEOS 64 che siano in grado di sfruttare il modo a 80 colonne offerto da GEOS 128 e 
la frequenza di clock di 2 MHz. Questo non significa però che ciò non sarà possibile 
in seguito. Qualsiasi applicazione realizzata per GEOS 64, come vedremo, può 
installare nel menu GEOS la voce switch 40/80, mettendo così a disposizione 
dell’utente uno schermo a risoluzione orizzontale duplicata (640 x 200). 

Per non creare inutili confusioni, nel corso del manuale faremo riferimento 
esclusivamente a GEOS 64, e dedicheremo il capitolo 21 alla trattazione di tutti gli 
argomenti utili al programmatore che voglia creare applicazioni compatibili con GEOS 
128. In quel capitolo si darà per scontato che il lettore abbia già letto l’intero manuale 
e sia quindi a conoscenza delle caratteristiche fondamentali del sistema operativo. Le 
appendici A e B, oltre a descrivere tutte le costanti e le variabili globali impiegate da 
GEOS 64, contengono anche informazioni utili per creare applicazioni che sfruttino 
alcune caratteristiche di GEOS 128. 


GEOS V1.3 e le espansioni RAM 

La versione 1.3 di GEOS, agli occhi dell’applicazione e dell’utente, fondamentalmen¬ 
te è solo un amplieimento della versione 1.2. Quindi tutte le routine della versione 1.2, 
i parametri, la struttura operativa e la dislocazione delle variabili globali, sono 
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mantenute integralmente nella versione 1.3. Ma alla struttura primitiva sono state 
aggiunte alcune altre capacità. Prima fra tutte, GEOS VI.3 è in grado di gestire le 
espansioni RAM REU (Ram Expansion Unit) e contiene alcune routine appositamente 
dedicate all'impiego della RAM aggiuntiva introdotta dai moduli d’espansione. 
Queste routine vengono illustrate nel capitolo 21 insieme alla compatibilità con GEOS 
128. Le espansioni RAM sono strumenti di lavoro utilissimi, in quanto, riducendo 
notevolmente le necessità di accesso al disco, consentono di risparmiare tempo di 
lavoro e quindi di accelerare le operazioni. A seconda della quantità di memoria 
aggiuntiva, GEOS è in grado di impiegare il modulo d’espansione per muovere grandi 
quantità di dati in tempi brevissimi, per simulare un drive (RAM disk), per installare 
uno Shadowed Drive e per ricaricare velocemente il sistema senza compiere accessi 
al disco, per esempio dopo aver mandato in esecuzione un file Basic. Ma l’aspetto più 
notevole di questi possibili impieghi è che le applicazioni non sono tenute a sapere 
come e in che modo GEOS sta impiegando l’espansione RAM inserita, dal momento 
che la sua gestione nei casi sopracitati viene interamente affidata al Kernel. 
Comunque, le applicazioni possono anche impiegare le espansioni RAM per svolgere 
compiti del tutto diversi, chiamando le apposite routine messe a disposizione dal 
Kernel. 

In GEOS VI.3 è stato migliorato ulteriormente il modulo che si interessa degli 
accessi al disco. In particolare è ora disponibile nella jump table a $C100 anche l’entry 
point della routine FreeBlock. Infine, nella nuova versione GEOS è in grado di gestire 
file di tipo AUTO-EXEC che vengono mandati in esecuzione automaticamente all’atto 
dell’installazione del sistema. Nel corso del manuale, quando verranno esposti 
argomenti che interessano esclusivamente la versione 1.3 di GEOS, sarà detto 
esplicitamente. In appendice vengono messe in evidenza tutte le costanti, le variabili 
e le routine che interessano esclusivamente la versione 1.3. 




2 LE ICONE 
E I MENU 


Le icone 

Introducendo la gestione delle icone diamo per scontato che il lettore abbia già 
utilizzato GEOS e che quindi sappia cosa significa aprire un menu o selezionare 
un’icona. Non ci dilungheremo a illustrare che cosa sono e come agiscono. In breve, 
attivare o selezionare un’icona significa posizionare il puntatore del mouse nella zona 
di schermo dove è visibile l’icona e premere il pulsante; questa operazione determina 
la chiamata della routine di servizio associata all’icona. Il modo di operare è simile a 
quello adottato per i menu, se si eccettua il fatto che l’utente, selezionando le voci di 
un menu, può addentrarsi in successivi livelli di sotto-menu prima di attivare una voce 
che determini la chiamata della routine di servizio associata. La struttura dei menu 
consente quindi una gestione degli eventi più articolata e gerarchica di quanto non 
accada con la struttura delle icone. Le icone e i menu sono definiti tramite tavole di 
dati. Il modo più facile per imparare a servirsene è vedere praticamente come si creano; 
iniziamo quindi a illustrare l’argomento realizzando una tavola di dati che definisce 
alcune icone. 

Di solito le icone vengono definite dalla routine d’inizializzazione dell’applicazione. 
Per esempio, deskTop definisce le icone associate ai file in maniera tale che 
effettuando una doppia pressione rapida del pulsante, quando il mouse si trova su una 
di esse, il file viene caricato in memoria dal Kernel di GEOS, il quale poi esegue un 
jsr all’indirizzo della routine d’inizializzazione dell’applicazione indicato nel blocco 
File Header. La semplice applicazione che ci apprestiamo a realizzare inizia 
all’indirizzo $0400. Il suo compito è solo quello di cancellare lo schermo chiamando 
i-Rectangle (routine che sarà descritta nel capitolo dedicato alla grafica), e 
successivamente definire le icone tramite la routine Dolcons. 
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Il programmatore deve creare la tavola di definizione delle icone, in maniera che poi 
il Kernel di GEOS vi possa accedere per ottenere tutte le informazioni di cui ha bisogno 
per gestire le icone desiderate. Per cedere al Kernel il controllo della tavola, 
l’applicazione deve passare alla routine Dolcons l’indirizzo di memoria dove questa è 
allocata. 

LoadW r0, QuantijriiTest Icons ; iridirizio della tavola di dati delle icone 

jsr Dolcons ;definisce e visualizza le icone 

La tavola delle icone indica il numero di icone da definire e dove posizionare il 
mouse dopo la loro visualizzazione. La nostra semplice applicazione definisce otto 
icone. La tavola delle icone è composta da gruppi di sette byte per ogni icona. 


Tavola delle icone 





X-POS-TOP-ICON 

_ 7 

,;La posizione x e y di un'icona e' riferita 
al 1 'angolo superiore sinistro del suo disegno 

jcoordinata x in byte dell'icona 

Y-POS-TOP-ICON 

= 10 

.1 coordinata y in pixel dell'icona 

SuantuffiTestlc 

Dns ; 


.byte 

8 

triuraero di icone 

, word 

160 

.1 coordinata x in pixel del mouse dopo 

, byte 

100 

l'apparizione delle icone 
; coordinata y in pixel del mouse dopo 

. word 

showCaseData 

j1'apparizione delle icone 

; GRUPPO 1 

.ipuntatore ai dati grafici dell'icona 

.byte 

X-POS-TOP-ICON 

jcoordinata x in byte dell'icona 

. byte 

Y-POS-TOP-ICON 

jcoordinata y in pixel dell'icona 

. byte 

£,. 16 

jlarghezza in byte e altezza in pixel dell'icona 

. word 

Do Show 

jroutine di servizio associata all'icona showCase 

. word 

justForFunData 

^ L'RUPPU d 

.'puntatore ai dati grafici dell'icona 

. byte 

X-POS-TOP-ICuN 

j eoordinata x in byte de 11'icona 

. byte 

Y-POS-TOP-ICON+30 

j eoo rdina t a y in pixe1 de 11'icona 

.byte 

2, 16 

jlarghezza in byte e altezza in pixel dell'icona 

. word 

DoFun 

jroutine di servizio associata all'icona ..lustForFun 



jal tri 6 gruppi per le rimanenti 6 icone 
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Il gruppo di ogni singola icona inizia con un puntatore ai dati grafici necessari per 
disegnarla. I dati grafici per ogni icona nella nostra semplice applicazione sono 
composti da 33 byte. Le due successive informazioni contenute nel gruppo 
rappresentano la posizione che avrà sullo schermo (le coordinate di posizione x e y di 
qualsiasi icona sono sempre riferite all’angolo superiore sinistro del suo disegno). I due 
byte seguenti contengono rispettivamente la larghezza in byte e l’altezza in pixel 
dell’icona. Infine troviamo l’informazione più importante: la word che contiene 
l’indirizzo della routine di servizio associata all’icona. Nella nostra applicazione tutte 
le icone definite corrispondono, per semplicità, alla stessa routine di servizio. 

Le due figure che seguono descrivono la routine di servizio della nostra applicazione 
e i dati grafici delle icone. 


Routine di servizio 


DoFun: 



;routine di servizio per l'icona JustForFun 

DoShou! 



jroutine di servizio per l'icona CoBinodore Software 

ShouCase: 



jle rimanenti 6 label di servizio delle icone 

jsr 

i-Rectangle 

^rettangolo che pulisce lo schermo 


.byte 

0 



.byte 

199 



,uord 

0 



.word 

319 



LoadU 

r0, ScreenSIcon ; indirizzo della tavola di dati per l'icona 


jsr 

Oolcons 

jvisualizza l'icona per ritornare a deskTopi 
jdev'essere definita almeno un'icona, 




;e' un bug di GEOS 


LoadU 

r0,QuantuiiiTe 

stMenu ; indirizzo della tavola di dati per il menu 


Ida 

#0 

jposiziona il mouse sul primo menu 


Jsr 

DoMenu 

;visualizza il menu 

rts 





La routine di servizio appena descritta esegue tre compiti. Inizia cancellando lo 
schermo (disegnando un rettangolo di dimensioni uguali a quelle dello schermo con 
la matrice grafica di default, ovvero lo sfondo). La seconda opereizione consiste nel 
definire una nuova struttura di icone che ne comprende solo una. La presenza di 
quest’icona è necessaria per due motivi: consente, se selezionata, di terminare 
l’appliceizione e ricaricare deskTop, ma soprattutto è un’esigenza di GEOS. Si tratta di 
un piccolo bug del sistema operativo. GEOS richiede che sia sempre definita almeno 
un’icona, anche se non viene utilizzata. In seguito ne verranno spiegati più 
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dettagliatamente i motivi. La terza operazione che la routine di servizio esegue 
consiste nel definire e visualizzare la struttura di un menu. Alla fine, viene ceduto il 
controllo a MainLoop, che gestisce la nuova icona e il nuovo menu. Tutte le label delle 
routine di servizio della prima struttura di icone (QuantumTestIcons) che abbiamo 
descritto neU’esempio, individuano la routine qui illustrata. 

Le routine di servizio d^e icone possono eseguire qualunque operazione. Possono 
anche inizializzare nuovamente l’intero sistema e, se necessario, possono controllare 
quale tipo di pressione del pulsante del mouse, singola o doppia, è avvenuta sopra 
l'icona associata. Nel capitolo precedente avevamo spiegato come una routine 
associata a otherPressVec può gerire la doppia (cessione del pulsante in aree non 
convenzionali, cioè diverse da icone e menu. Trattandosi di un caso un po’ atipico, 
l’applicazione doveva procedere in modo autonomo all’analisi del contatore 
CLICK-jCOUNT e alle altre procedura necessarie. 

Ora invece analizzeremo la doppia pressione del pulsante del mouse in un’area 
convenzionale: un’icona. In questo caso è il Kernel di GEOS che analizza il contatore 
in maniera completamente autonoma, sollevando l’applicazione da operazioni 
estranee ai suoi scopi. Gestire la doppia pressione del pulsante è molto più semplice 
quando il mouse si trova su un’icona, piuttosto che quando si trova su un'area non 
convenzionale (nel qual caso si sarebbe proceduto attraverso il vettore otherPressVec). 
La routine di servizio dell’icona selezionata, riceve in rOH, dal Kernel di GEOS, il valore 
TRUE ($FF) per indicare la doppia pressione, e FALSE ($00) per indicare la pressione 
singola. Il registro rOL viene restituito con il numero dell’icona. Questo numero 
corrisponde all’ordine di posizione lungo la tavola di definizione. La prima icona della 
tavola ha il numero 0. Conoscere il numero dell’icona attivata può apparire inutile se 
a ognuna è associata una routine particolare, che determina implicitamente quale 
selezione è avvenuta. Diventa importante, invece, se icone diverse hanno la stessa 
routine di servizio, ma questa viene eseguita in modo leggermente diverso in base al 
numero dell’icona selezionata. 

Per concludere, dobbiamo definire i dati che comporranno il disegno in modo 
bit-map associato a ogni icona, e che saranno indicati in memoria dalla tavola di dati 
delle icone. 
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Tavola dei ciati grafici 


shouCaseOata: 

.byte $02,$FF,$9C,$80,$01,*80,$39,$80,$6D,t80,$E5,$81,$BD,$83,$19,l86 

• byte $31,$8C,$61,$98,$Cl,fBl,l81,IBB,$01,t-BE,l01,tBC,$01,$88,t01,$02 

.byte $FF 

justForFunData: 

.byte $02;IFF,l9C,$87,$01;$8D,l81,l9E,$Cl;fBB,l61,$ftD,$Bl,$B6,t99,f9B 

.byte $09,$9D,$0O,$96,$07,»9ft,»03,$8C,$01,$87,IEl,$8fl,$31,$80,tl9,$02 

.byte fFF 

... ji dati grafici risananti per le altre 6 icone 


Il disegno delle icone è in modo bit-map. Queste icone sono larghe 2 byte e alte 16 
linee di scansione. I dati sono compattati nel modo BitmapUp (vedere BitmapUp nel 
capitolo dedicato alla grafica). Le mappe dei bit per queste icone non si compattano 
efficacemente: utilizzano infatti un byte in più del formato standard (la compattazione 
dei dati grafici può essere molto efficiente: per esempio l’intera riga di comemdi in 
geoWrite occupa 16 byte). La lista completa dei dati grafici per ogni icona è riportata 
più avanti. 

A questo punto della trattazione è importante introdurre la particolare tecnica di 
gestione delle icone utilizzata da deskTop e geoPaint. Nell’applicazione deskTop, 
quando l’utente preme il pulsante del mouse sopra un’icona associata a un file, l’icona 
si inverte per segnalare che è stata selezionata. L’icona del file rimane invertita fino 
a quando non viene selezionata un’altra icona. L’utente può poi aprire un menu e 
selezionare una voce: per esempio, info. La routine di servizio associata alla voce info 
preleva le informazioni dal file la cui icona è invertita. Una procedura simile è adottata 
anche da geoPaint quando viene selezionato un comando grafico. L’icona del comando 
rimane invertita fino a quamdo l’utente non ne attiva un’altra. Selezionando un’altra 
icona, la prima si inverte nuovamente per assumere lo stato normale di “non attivata”, 
e la nuova icona si inverte per assumere lo stato di "attivata". Vediamo come avviene 
questa interazione, nel primo caso fra un’icona e un menu, e nel secondo caso fra due 
icone. 

Nel Kernel di GEOS è presente una variabile denominata iconSetFlag. I bit 6 e 7 si 
occupano di come segnalare all’utente l’awenuta selezione di un’icona. Se il bit 7 è 
impostato a 1, l’icona viene solo momentaneamente invertita per indicare che è stata 
selezionata. Il programmatore, per impostare a 1 questo bit, dispone della costante 
SET-FLASH = $80, che consente di non dover ricordare a memoria quale bit e quale 
valore impostano questa opzione. Il tempo durante il quale l’icona rimane invertita 
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è deteinninato dalla vaiiabile selectionFlash. Il suo valore di default è SELEC- 
TION-DELAY = 10. 

Se il bit 7 è impostato a 0 e il bit 6 a 1, l’icona selezionata si inverte e rimane in questo 
stato. La costante per questa opzione è ST-INVERT = $40. In questo caso la routine 
di servizio associata all’icona deve memorizzare nelle variabili dell’applicazione lo 
stato dell’icona, il suo numero e qualsiasi altra informazione si renda necessaria. 
Quando poi viene selezionata la voce di un menu, la routine di servizio associata a 
questa voce esamina le variabili dell’applicazione per scoprire se c’è un’icona in stato 
di “attivata”, cioè invertita, e operare le appropriate scelte. Nell’esempio della voce 
info, la routine di servizio dell’icona appena selezionata inverte nuovamente l’icona 
tramite la routine InvertRectangle, riportandola così allo stato di non attivata, e preleva 
le informazioni dal file per mostrarle all’utente. 

Se entrambi i bit 6 e 7 di iconSetFlag sono azzerati, l’attivazione dell’icona non 
produce alcun cambiamento nel suo disegno. 

Una nota importante prima di terminare la trattazione sulle icone; GEOS, per come 
è stato realizzato, esige che l’applicazione definisca sempre almeno un’icona. Se 
l’applicazione che state creando non deve utilizzare alcuna icona, è necessario crearne 
una ugualmente. Definitela larga un byte e alta una linea di scansione, e impostate 
il suo puntatore ai dati grrafici del disegno uguale a 0. In questo modo non siete costretti 
a definire un disegno fittizio e l’icona non potrà mai essere selezionata. 

Il Kernel di GEOS prevede una sola routine per attivare le icone: Dolcons. 





Funzione: Disegna e attiva le icone definite nella Icon Table (tavola di definizione delle 

icone). 

Indirizzo: $C15A 

Parametri: rO puntatore alla Icon Table 

Restituisce: Niente 

Distrugge: a, x, y, rO - r11 

Sinossi: Oolcons disegna le icone come sono definite nella Icon Table puntata da rO. 

Quando sono state disegnate, l'utente può selezionarle tramite H mouse. 
Attivando un’icona, viene eseguita la routine di servizio indicata nella Icon 
Table. 

Per disattivare completamente un'icona, bisogna azzerare il suo puntatore 
ai dati grafici. Se l'icona è già stata visualizzata bisognerà cancellarne il 
disegno dallo schermo. Se il puntatore ai dati grafici è azzerato, non apparirà 
alcun disegno. 

L’unico modo affidabile per disattivare un intero set di icone visualizzate 
è cancellare lo schermo e inizializzarne un altro, oppure azzerare tutti i 
puntatori ai dati grafici. 

Il Kernel di GEOS comunica alla routine di senrizio associata all’icona, 
tramite il registro rOH, il valore TRUE ($FF) per indicare la doppia pressione 
dd puisarìte del mouse sull'icona, e il valore FALSE ($00) per indicare la 
pressione singola. Il Kernel comunica inoltre, nel registro rOL, il numero 
dell’Icona corrispondente al numero d’ordine con il quale appare nella Icon 
Table. La prima icona è numerata con 0. Questo numero d’ordine è utile 
soprattutto quando accade che a icone diverse sia associata la stessa 
routine di servizio, senza però che il cx)mportamento di questa routine sia lo 
stesso per ogni icona selezionata. 
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I menu 

Come per le icone, procediamo -a illustrare il funzionamento dei menu con vm 
esempio. La prima cosa da fare è realizzare una chiamata come la seguente; 

LoadM r0, TestMenu ;puntatore alla tavola di definizione del menu 

Jsr OoMenu jdefinisce il nenu 


Esattamente come per le icone, i menu sono definiti attraverso la tavola dei dati. La 
semplice applicazione che stiamo creando contiene la struttura completa di un menu, 
che analizzeremo un passo alla volta. 

I menu possono aprirsi sia verticalmente sia orizzontalmente. In deskTop la linea 
comandi che compare sullo schermo in alto a sinistra è un menu orizzontale. I primi 
quattro parametri che compongono la tavola di dati sono le dimensioni geometriche 
del menu: dove iniziano i lati superiore, inferiore, destro e sinistro. Il lato superiore 
coincide di solito con il bordo superiore dello schermo, e il lato inferiore si calcola 
tenendo conto che ogni voce, nel caso di un menu verticale, occupa 14 pixel 
(dimensione ottimale quando si utilizza il set di caratteri standard). Quindi al lato 
superiore aggiungiamo 14 pixel per ogni voce, in modo da ottenere la posizione del lato 
inferiore del menu. 

II lato destro di un menu orizzontale crea qpalcdie problema in più. Innanzitutto i 
menu orizzontali si aprono verso destra. Questo sigrùfica che se apriamo un menu 
verticale e selezioniamo una voce che apre un altro menu orizzontale (struttura 
nidificata dei menu), quest’ultimo si apre a destra della voce. Il problema della 
determinazione del lato destro è che la larghezza di una voce dipende dalla lunghezza 
della parola che contiene. Dal momento che i caratteri non sono tutti delle stesse 
dimensioni e la spaziatura è proporzionale, non è a priori possibile per il 
prograrrunatore stabilire l'esatta larghezza del menu orizzontale. Tale dimensione si 
determina sperimentalmente, iniziando con im tentativo sovradimensionato e 
controllemdo che il box dell’ultima voce a destra si inverta completamente e non 
parzialmente. Nel corso di questa operazione, bisogna anche tener presente la 
possibilità che il menu sia troppo corto e che selezionemdo Tultima voce a destra venga 
non solo invertito il box, ma anche parte dello sfondo. Sono quindi necessari alcuni 
tentativi prima di trovare la dimensione appropriata. Fate attenzione, però, perché 
possono verificarsi strani e imprevedibili bug se il box della voce ha dimensioni tali 
da invertire parti dello sfondo. 

Basandosi sulle dimensioni definite nella tavola di dati, GEOS disegna un lungo box 
per creare il menu. Successivamente scrive le parole chiave delle singole voci una dopo 
l’altra sulla stessa linea, separandole fra di loro con una barretta verticale |. Le barrette 
verticali dividono il menu in voci separate. Se il valore impostato per la posizione del 
lato destro del menu orizzontale è sovradimensionato, l’ultima voce si limiterà ad avere 
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molti spazi dopo la parola. In questo caso è semplice procedere alla regolazione 
ottimale della larghezza del menu. 

La quinta informazione definisce il tipo di menu, orizzontale o verticale, e il numero 
di voci di cui è composto. Questi due parametri sono contenuti nello stesso byte perché 
occupano bit diversi; l’informazione è costituita dal risultato deU’operazione OR fra i 
due vederi. I primi cinque parametri dovrebbero apparire così: 


Dimensioni del menu 




;Costanti per le dimensioni 

del menu 

«fllN-TOP 

= 10 

; lato 

superiore del menu 


MfllN-BOT 

= 24 

; lato 

inferiore del menu 


MflIN-LFT 

= 0 

; lato 

sinistro del menu 


«flIN-RT 

= 255 

; lato 

destro (sperimentale) 

del menu 

QuantumTestHenu: 




• byte 

MfllN-TOP 

; lato 

superiore del menu 


.byte 

«fllN-BOT 

1 lato 

inferiore del menu 


.word 

MfilN-LFT 

1 lato 

sinistro del menu 


.word 

MfilN-RT 

1 lato 

destro del menu 


.byte 

H0RIZ0NTflL|2 

j tipo 

del menu OR'ed(t) con 

il numero delle voci del menu 


La selezione dei menu 

Passiamo a descrivere in dettaglio i parametri associati a ogni voce che appare nel 
menu. Ogni voce è caratterizzata da tre parametri. Il primo è un puntatore alla stringa 
di testo che appare nella voce. La stringa di testo può contenere qualsiasi carattere 
visualizzabile, compresi gli spazi fra le parole. La seconda informazione è un byte che 
indica il tipo di voce del menu. La selezione di un menu può aprire un sotto-menu o 
causare la chiamata di una routine di servizio. In deskTop le voci del menu principale 
orizzontale aprono altri sotto-menu. A loro volta le voci dei sotto-menu possono aprire 
altri sotto-menu o chiamare routine di servizio. La terza informazione è un puntatore 
che, a seconda del caso, contiene l’indirizzo della tavola di dati associata al 


(t) L'operazione logica OR fra due valori è indicata per brevità con il verbo OR'ed. Per esempio, 
HÒRIZONTAL OR’ed con 7 indica che il risultato è costituito dall’operazione logica OR eseguita fra il valore 
della costante HORIZONTAL e il numero 7. 
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sotto-menu, o l’indirizzo della routine di servizio da eseguire. Le due voci del menu 
orizzontale della nostra applicazione d’esempio sono illustrate nella seguente figura. 


Voci de! menu 


.word 

ChangeDeptTe.xt 

jpuntatore alla stringa di testo terminante 
; con uno 0 (stringa a terminazione nulla) 

.byte 

SUB-MENU 

jflag per indicare che gues.ta voce apre un sotto-menu 

.word 

ChangeDeptMenu 

jpuntatore alla struttura del sotto-menu 

.word 

ShowCaseText 

jpuntatore alla stringa a terminazione nulla 

.byte 

SUB-MENU 

jflag per indicare che questa voce apre un sotto-menu 

.word 

ShowCaseMenu 

jpuntatore alla struttura del sotto-menu 


Per completezza, anche se l’applicazione d’esempio che stiamo analizzando sarà 
interamente ripresa per essere realizzata in pratica, seguono le stringhe di testo a cui 
fa riferimento la tavola della figura precedente: 

ChangeDeptText; .byte "ChangeOepartmerits", 0 

ShotiiCaseText : .byte “Commodore SoftwareShowcase”, 8 

Le strutture dei due sotto-menu richiamati nella precedente figura sono illustrate 
nella pagina successiva. L’esempio completo apparirà nel capitolo seguente. Dal 
momento che le strutture dei menu sono ripetitive, ne analizzeremo uno o due esempi 
per ogni tipo, rimandando il lettore al prossimo capitolo per la trattazione completa. 

La struttura di un sotto-menu è simile a quella dei menu principali. Le prime scelte 
da operare riguardano la posizione che deve assumere il sotto-menu quando viene 
visualizzato. Nella nostra applicazione, la voce Change Departments del menu 
principale controlla un sotto-menu verticale che si estende sotto di essa. In questo caso 
la dimensione verticale del sotto-menu viene calcolata tenendo conto del numero di 
voci di cui è composto e allineandolo esattamente sotto il menu principale. Per quanto 
riguarda le dimensioni orizzontali, è ancora necessario procedere per tentativi. Si deve 
allineare il lato sinistro del sotto-menu con la barretta verticale che corrisponde 
all’inizio della voce del menu principale che lo controlla, mentre il lato destro deve 
consentire alla voce più larga del sotto-menu di invertirsi correttamente. Ovviamente, 
trattandosi di un menu verticale, le voci più corte hanno spazio in eccesso alla loro 
destra, ma il Kernel di GEOS inverte i loro box fino al lato verticale destro. La 
determinazione delle dimensioni del menu verticale sarà più chiara rifacendosi a un 
esempio. I primi parametri del sotto-menu ChangeDeptMenu, le dimensioni e il tipo. 
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mostrano che è un menu verticale. È composto da otto voci e ognuna attiva un 
MENU-ACTION, cioè una routine di servizio, anziché altri sotto-menu(t). Nella figura 
che segue appaiono solo le definizioni delle prime due voci, dal momento che la 
struttura non cambia ed è la stessa che abbiamo analizzato per il menu principale. 


Le voci del sotto-menu Change Departments 


Chan 9 eDeptNenu: 


.byte 

MfllN-BOT 

;il lato superiore del sotto-menu coincide con il lato 
; inferiore del menu principale 

.byte 

MflIN-BOT+StH-l-l 

;il lato inferiore deLsotto-menu viene determinato 
; aggiungendo 14 linee di scansione per voce 

.word 

MflIN-LFT 

;lato verticale sinistro del sotto-menu 

.word 

llfiIN.LFT+155 

jlato verticale destro del sotto-menu 

.byte 

VERTICflL|8 

jtipo menu OR'ed con il numero di voci 

.word 

ShowCaseText 

; testo per questa voce 

.byte 

MENU-flCTION 

;flag per indicare una routine di servizio 

.word 

ShowCaseDsp 

jindirizzo della routine di servizio 

.word 

FunText 

; testo per questa voce 

•.byte 

MENU-flCTION 

jflag per indicare una routine di servizio 

\.word 

FunDsp 

jindirizzo della routine di servizio 

jaltri 6 gruppi di dati per le voci rimanenti 


Questo sotto-menu è composto da otto voci, due delle quali sono riportate nella 
figura precedente. Le rimanenti sei sono dello stesso tipo. Il lato superiore del 
sotto-menu di solito è posizionato in corrispondenza del lato inferiore del menu 
principale che l’ha generato {non rappresenta una regola fissa). Ogni voce del 
sotto-menu verticale misura in altezza 14 linee di scansione. GEOS aggiungerà una 
linea di scansione in più al lato inferiore. Il lato inferiore del menu può essere 
determinato come segue: 

Lato inferiore = Lato superiore + (Numero di voci * 14) + 1 


(t) È possibile creare una struttura di sotto-menu orizzontali e verticali con una profondità arbitraria. La 
selezione della voce di un menu orizzontale può aprire un sotto-menu verticale, le cui voci a loro volta 
possono aprire altri sotto-menu orizzontali e così via, generando una struttura di menu a elevata profondità. 
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Questa è l’unica dimensione dei menu che è possibile determinare con esattezza 
senza dover ricorrere a una serie di tentativi. Questo sotto-menu è definito con il lato 
verticale sinistro nella stessa posizione del lato sinistro del menu principiale. La 
posizione del lato destro dev’essere determinata sperimentalmente. La prima voce 
contiene il testo puntato da ShowCaseText, e quando è attivata causa un 
MENU-ACTION; viene eseguita la routine di servizio ShowCaseDsp, puntata dalla 
word successiva nel gruppo di dati. 

Le altre voci sono del tutto simili. Dopx) lajstruttuia,del sotto-menu ChangeDeptMe- 
nu, segue quella associata a ShowCaseMenu. Questo secondo sotto-menu, controllato 
dalla seconda voce del menu principale, è uguale al primo che eibbiamo trattato, a 
parte il fatto che è un sotto-menu obbligato (constrained). Il gruppo di dati pier questo 
sotto-menu è riportato nel listato dell’applicazione esemplificativa che si trova 
(completo) nel prossimo capitolo. “Obbligato” significa che il mouse non può uscire dai 
suoi bordi. Questa opzione è utile pjer p)ermettere all’utente di muoversi velocemente 
aH’interno del sotto-menu aperto senza correre il rischio che il mouse esca dai limiti 
del sotto-menu e attivi la scomparsa dello stesso. È una caratteristica molto utile per 
menu con diverse voci, o menu orizzontali apierti da un menu verticale, dove uno 
spostamento accidentale del mouse può chiudere entrambi i menu. L'indicatore dello 
stato d'obbligo è un bit nel byte del tipo di menu: 

.byte C0NSTRflINED|VERTICflL|7 ;menu obbligato, tipo di menu, numero di voci 

Dopo ShowCaseMenu sono indicate 15 stringhe di testo per le voci dei due 
sotto-menu, anche queste riportate nel prossimo capitolo. Per finire rimangono da 
definire le routine di servizio associate alle voci dei sotto-menu. Queste routine 
possono eseguire qualunque operazione, ma devono includere almeno una chiamata 
a una routine di gestione dei menu, come GotoFirstMenu, per esempio, che disattiva 
tutti i sotto-menu ap)erti, facendoli scomp>arire e lasciando soltanto il menu principale. 
Le nostre routine di servizio eseguono solo questa operazione, chiamando GotoFir¬ 
stMenu. 

LearningDsp: 

FunOsp: 

ServiceOspi 
InfoNetDspi 
PeopleConDspi 
NewsDsp: 
nallDsp: 

CatalogDsp: 

PreviewDspi 
SigLìbOsp; 


jroutine di servizio del sotto-menu associato alla voce 
jChange Departments del menu principale 


,'routine di servizio del sotto-menu associato alla voce Software 
iShouCase 
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FileTransDspi 

R«viewOsp! 

PostOfficeDsp: 

ChangeDspi 

ShouCaseOsp: 

jsr GotoFirstMenu jdisattiva tutti i sotto-»enu 

rts 

Questo è tutto quello che c'è da sapere p«c costruire una semplice struttura di menu. 
GEOS permette di effettuare molte variazioni alla struttura principale. Per esempio, 
prevede una routine che può essere impiegata ai posto di GotoFirstMenu, 
DoPreviousMenu, la quale chiude solo l’ultimo sotto-menu aperto. Questa routine 
permette all’utente di selezionare più voci dello stesso menu senza doverlo riaprire. Per 
esempio, supponiamo di avere un menu verticale con le voci A, B, C, e D. Ognuna di 
queste voci apre un menu orizzontale con le voci 1, 2, 3, e 4. L’utente desidera 
selezionare l’opzione 1 del sotto-menu corrispondente alla voce D, e l’opzione 3 del 
sotto-menu corrispondente alla voce C. Quemdo l’utente seleziona l’opzione 1 sotto D, 
la routine di servizio associata chiama DoPreviousMenu, e anziché produrre la 
scomparsa di tutti i sotto-menu, cancella solo il sotto-menu orizzonmle D. In questo 
caso la routine di servizio deve anche preoccuparsi di aggiornare le variabiU 
mouseXPos e mouseYPos in modo che il mouse, dopo la scomparsa del sotto-menu, si 
trovi sul menu verticale. In caso contrario, quando il Kernel di GEQS chiude il 
sotto-menu orizzontale, il mouse non si trova sul menu verticale e il Kernel interpreta 
questa situazione come l’uscita dell’utente con il mouse dal menu verticale, e di 
conseguenza chiude anche il menu verticale. 

Le routine di servizio associate ai menu possono essere anche molto sofisticate. 
Possono perfino modificare se stesse o la struttura dei menu (un’operazione comunque 
sconsigliabile per chi è alle prime armi). Per esempio, la routine di servizio può 
aggiungere un asterisco al testo di ima voce di modo che quando il sotto-menu viene 
aperto per la seconda volta, l’utente può sapere quali voci ha già attivato. Questo 
accorgimento viene utilizzato in geoWrite per mostrare se opzioni come bold (nero) o 
italic (corsivo) sono già state utilizzate. Ogni volta che una di queste opzioni viene 
selezionata, la routine di servizio esegue i suoi compiti primari, e inoltre accede alla 
tavola di dati associata al menu e aggiunge un asterisco (o lo cancella se è già 
presente) al testo della voce selezionata. 

C’è un altro tipo di menu chiamato DYN-SUB-MENU che permette al programma¬ 
tore di creare una routine da eseguire prima che il menu venga veramente aperto sullo 
schermo. La word che segue .byte DYN_SUB-14ENU è un puntatore che contiene 
l’indirizzo della routine da eseguire prima che venga aperto il sotto-menu. Per i menu 
normali, questa word punta alla struttura del sotto-menu; quindi la routine di 
preparazione, eseguita prima dell’apertura del sotto-menu, deve aggiornare rO con 
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Tindirizzo della struttura del sotto-menu da aprire, e infine terminare con un solo rts. 

I sotto-menu dinamici sono utili per creare una struttura di menu elastica, cioè 
adattabile a situazioni particolari. La routine può controllare lo stato del sistema e 
modificare la tavola di dati associata, prima che il sotto-menu venga aperto. Nel 
capitolo dedicato alla gestione dei testi è illustrato un metodo per creare il menu dei 
corpi carattere quando si sceglie una fonte carattere (come appare in geoWrite e 
geoPaint). All’atto della scelta della fonte carattere, la routine di preparazione 
dinamica del sotto-menu controlla quali corpi carattere sono associati alla fonte 
prescelta e costruisce la tavola di dati per il sotto-menu. Le varie possibilità di gestione 
dei menu, inclusi i menu dinamici, sono riassunte nello schema che segue. 


Le costanti per i menu 


Tipo di menu 


HORiZONTAL 


VERTICAL 


CONSTRAiNED 


Le voci del menu sono disposte orizzontalriiente 

«ece li voce 2|*oce S 

Le voci del menu sono disposte verticalmente 

waeel 

wb»2 

w>e>a 

Il [fiouse e' obbligato a non uscire dai lati e dal bordo 
inferiore del menu, Se non si effettuano 
selezioni, si può' chiudere il menu spostando il mouse oltre 
il lato superiore 


Tipo di selezione del menu 


SUB-MENU 


MENU-ACTION 


DYN-SUB-MENU 


Questa scelta apre un altro livello di sotto-menu, E' seguita 
da un puntatore alla struttura del sotto-menu 

Questa scelta determina l'esecuzione della routine di 
servizio associata, il cui indirizzo e' contenuto nel puntatore 
che segue 

Questa scelta determina la chiamata a una routine 
di preparazione, prima che il sotto-menu venga aperto. 

La routine, quando termina, deve impostare r0 con 
l'indirizzo della struttura del sotto-menu 









Funzione: Disegna e attiva la struttura dei menu puntata da rO. 

indirizzo: $C151 


Parametri: a numero dalla voce su cui si posiziona il mouse 

(0 indirizzo della tavola di dati 

Restituisce: Niente 

Distrugge: rO - r13, a, x, y 

Sinossi: Cedendo il controllo della tavola di definizione, DoMenu disegna i menu e ne 

cede il controllo al Kernel. Se la tavola di definizione è corretta, DoMenu è 
in grado di gestire una struttura di menu di livello arbitrario. Dopo che i menu 
sono stati inizializzati da DoMenu, la loro manipolazione viene eseguita dal 
Kernel di GEOS in MainLoop. Premendo il pulsante del mouse sopra la voce 
di un menu, il Kernel di GEOS apre un sotto-menu o chiama la routine di 
servizio. 

DoMenu è normalmente chiamata dalla routine d'inizializzazione dell’appli¬ 
cazione (GEOS dopo aver caricato un’applicazione la manda in esecuzione 
airindirizzo d’inizializzazione specificato nel File Header, indirizzo al quale si 
trova in genere anche una chiamata alla routine DoMenu). 






Funzione: Riabilita un menu, cioè fa in modo che non scompaia quando una voce viene 

selezionata, in modo da permettere all’utente di selezionarne un’altra. 

Indirizzo: $C193 


Parametri: Nessuno 

Restituiace: Niente 
Distrugge: rO - r13, a, x, y 

Sinossi: Il codice di MainLoop che gestisce la struttura dei menu è a conoscenza dei 

dati relativi all’ultimo livello di menu aperto. Quando viene attivata una voce 
di tipo MENU-^CTION , MainLoop chiama la routine di servizio associata. 
All’intemo di questa routine il programmatore deve indicare a GEOS come 
utilizzare l’ultimo livelb di menu aperto. ReDoMenu riabilita l’ultimo livello di 
menu in modo che si possa selezionare un’altra voce senza dover riaprire 
il sotto-menu. 






Funzione: Disabilita il sotto-menu correntemente aperto e lascia abilitati (cioò non 

chiude) gli altri menu eventualmente aperti. 

Indirizzo: $0190 


Parametri: Nessuno 

Restituisce: Niente 
Distrugge: rO - r13, a, x, y 

Sinossi: Il codice di MainLoop che gestisce la struttura di menu è a conoscenza dei 

dati relativi all’ultimo livello di menu aperto. Quando viene attivata una voce 
di tipo MENU-ACTION, MainLoop chiama la routine di servizio associata. 
All’Interno di questa routine il programmatore deve indicare a GEOS come 
utilizzare l’ultimo livello di menu ap«to. 

DoPreviousMenu chiude l’ultimo menu, e lascia abilitata tutta la 
precedente struttura già aperta. Il mouse è abilitato in modo da permettere 
all’utente di selezionare un’altra voce del menu precedente. Prima di 
chiamare DoPreviousMenu, bisogna ricollocare il mouse sul menu preceden¬ 
temente aperto, altrimenti il Kernel di GEOS interpreterà la situazione 
corrente come segue: 

1) si accorge che il mouse si trova fuori dai limiti del menu 

2) presume che l’utente abbia spostato il mouse al di fuori del menu 
per cancellarlo 

3) cancella tutti i sotto-menu aperti. 






Funzione: Chiude tutti i sotto-menu dperti. Viene chiamata date routine di servizio delta 

voce. 


Indirizzo: $C1BD 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: rO - r13, a, x, y 

Sinossi: Quando viene attivata una selezione di tipo MENU-ACTION, il codice di 

gestione dei menu contenuto in MainLoop chiama la routine di servizio 
associata alla voce. La routine deve indicare a GEOS come utilizzare la 
struttura di menu aperta. 

GotoFirstMenu disabilita tutta la struttura dei sotto-menu correntemente 
aperta e lascia attivo solo il menu principale. 
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RecoverMenu 


Funzione: 

Ripristina lo sfondo coperto dall’ultimo menu copiandolo dal buffer di 
schermo. La routine non riattiva il livello superiore di menu. 

Indirizzo: 

$C154 

Parametri: 

Nessuno 

Restituisce: 

Niente 

Distrugge: 

r2 - r8, r11, a, x, y 

Sinossi: 

Questa routine ripristina lo sfondo coperto dal menu corrente. A differenza 
di DoPreviousMenu, RecoverMenu non riattiva il menu di livello precedente. 
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RecoverAIIMenus 


Funzione: 

Riprìstina lo sfondo coperto da tutti i menu aperti, compreso il menu 
principale. 

Indirizzo: 

$C157 

Parametri: 

Nessuno 

Restituisce: 

Niente 

Distrugge: 

r2 - r8, r11, a, X, y 

Sinossi: 

Riprìstina to sfondo coperto da tutti i menu correntemente aperti, compreso 
il menu principale. A differenza di GotoFirstMenu, RecoverAIIMenus disattiva 
completamente la struttura dei menu cancellandola interamente dallo 
schermo. 
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Realizzazione ed esecuzione dell’applicazione 

Abbiamo trattato gli argomenti principali per impiegare i menu e le icone e siamo 
ora in grado di creare una semplice applicazione che li utilizzi. Il passo successivo 
consiste nel realizzarla praticamente ed eseguirla. Prima di continuare dobbiamo 
preparare l’ambiente di lavoro e rendere accessibili all’applicazione le informazioni 
simboliche di GEOS: indirizzi delle routine, costanti, variabili. 

Per i programmatori che desiderano realizzare applicazioni in ambiente GEOS, la 
Berkeley Softworks ha prodotto geoProgrammer. Si tratta di un pacchetto professionale 
pensato espressamente per creare applicazioni GEOS compatibili (se necessario può 
essere usato anche per applicazioni non GEOS compatibili). 

Il pacchetto raccoglie tre strumenti fondamentali per il programmatore: un 
assembler, un linker e un debugger. geoAssembler, oltre a leggere i file sorgente creati 
con geoWrite, gestisce numerosi pseudocodici per creare qualsiasi tipo di compilazio¬ 
ne condizionale. Dal momento che il file sorgente viene creato con geoWrite, può 
contenere al suo interno qualsiasi elemento atto a migliorare la presentazione grafica 
del documento e la sua leggibilità. Nel testo possono essere incluse, ad esempio, anche 
figure, che geoAssembler provvede a trasformare in codici automaticamente. 
geoLinker assembla i vari moduli di un’applicazione in uno stesso file eseguibile. 
Tramite geoLinker, il programmatore può creare file con struttura SEQUENTIAL, VLIR 
e file Desk Accessory (accessori da scrivania). geoDebugger permette di collaudare 
l’applicazione direttamente in memoria disassemblando i codici delle istruzioni e 
permettendo all’utente di correggerli. Questa applicazione consente anche di mandare 
in esecuzione un’istruzione alla volta e di eseguire le subroutine come singole 
istruzioni. Inoltre permette di interrompere l’esecuzione dell’applicazione con la 
pressione di un tasto e di stabilire fino a 8 breakpoint condizionali. Quando il 
programma incontra un breakpoint, geoDebugger apre una finestra indipendente 
dall’applicazione sottoposta al test, nella quale visualizza l’errore. Nel pacchetto 
geoProgrammer, oltre a questi fondamentali strumenti di lavoro, il programmatore ha 
a disposizione anche una serie di applicazioni GEQS compatibili incluse come esempi 
pratici. 

Se non si dispone del pacchetto geoProgrammer, si deve affrontare un problema di 
non semplice soluzione: i file utilizzati da GEQS sono diversi dai file standard gestiti 
dal C-64. I compilatori Assembly conentemente in commercio non sono in grado di 
salvare i file in standard GEOS. Dobbiamo quindi trovare un modo per scavalcare il 
problema. 

A questo scopo si utilizza uno stratagemma che consente di realizzare l’applicazione 
con un file PRG standard C-64. Dopo aver creato l’applicazione nel formato PRG, si 
manda in esecuzione un semplice programma in Basic che traduce il file PRG in un 
file GEOS di tipo APPLICATION. Trattiamo questo argomento nei dettagli, prima di 
proseguire alla realizzazione dell’applicazione, per essere padroni degli strumenti 
necessari a un lavoro quanto più possibile rapido ed efficiente. 
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Lo scopo di questo capitolo è risolvere tutti i problemi in cui il programmatore può 
incappare realizzando ed eseguendo nel proprio ambiente di lavoro un’applicazione in 
stsmdard GEOS. 

Le costanti, le variabili, le routine e le macro 

La semplice applicazione che troverete nel prossimo capitolo è stata prodotta 
impiegando il nostro compilatore Assembly. Il vantaggio d’impiegare un linguaggio 
simbolico nei file sorgente dell’applicazione sta nella migliore leggibilità dei codici 
che sono attualmente in esecuzione nel C-64. Il file sorgente dell’applicazione inizia 
con una serie di linee contenenti la direttiva “.include nomefile”. La direttiva “.include” 
indica al nostro compilatore che in quel punto del file sorgente dev’essere inserito un 
testo proveniente da un altro file il cui nome è indicato da nomefile. Per poter utilizzare 
tutti gli pseudonimi per le costanti, le variabili, le routine e le macro, ogni applicazione 
deve contenere nel suo file sorgente la direttiva .include per richiamare i file 
geosConstants, geosMemoryMap, geosRoutines e geosMacros. “geosConstants” 
contiene la definizione di tutte le costanti di sistema utili alla programmazione. 
“geosMemoryMap” contiene la definizione di tutte le variabili e dei buffer di sistema. 
“geosRoutines" contiene gli indirizzi associati agli pseudonomi delle routine di 
sistema; questi indirizzi sono contenuti nella jump table del sistema. “geosMacros” 
contiene tutte le definizioni delle macro istruzioni impiegate in questo libro. 

Questi file sono contenuti in appendice. Il primo lavoro che il programmatore 
dovrebbe svolgere è quello di includerli nel proprio sistema, in modo da renderli 
disponibili per ogni applicazione. Eseguita questa operazione, è buona norma 
preparare alcune copie di sicurezza. Se il vostro compilatore Assembly è in grado di 
gestire solo un file alla volta, cioè non è in grado di inserire i testi di file esterni durante 
la compilazione, allora dovete inserirli in ogni file che create per realizzare le 
applicazioni. Può inoltre accadere che il vostro compilatore non accetti label di 
lunghezza superiore a 8 o 9 caratteri. 

Quando questo noioso lavoro è stato svolto, il vostro ambiente di lavoro è pronto per 
iniziare a compilare i file sorgente delle applicazioni che creerete. Una buona idea per 
iniziare a programmare consiste nel realizzare la semplice applicazione che vi 
proponiamo, o una simile, in modo da operare i ritocchi necessari al vostro sistema di 
lavoro perché si adatti perfettamente alla struttura di programmazione richiesta da 
GEOS. Nel pacchetto di programmazione geoProgrammer i file geosConstants, 
geosMemoryMap, geosRoutines e geosMacros sono già disponibili. 

La struttura dell’applicazione 

I file in formato GEOS contengono un blocco extra, rispetto ai file normali, chiamato 
blocco File Header. Questo contiene i dati grafici dell’icona associata al file e altre 
informazioni necessarie a GEOS per documentare il file e manipolarlo correttamente. 
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come Tindirizzo al quale allocarlo in memoria e Tindirizzo al quale mandarlo in 
esecuzione. 

L’indirizzo al quale allocarlo indica da che punto in poi nella memoria del calcolatore 
dev’essere caricato il file. L’indirizzo al quale eseguirlo indica a GEOS dove si trova 
la routine d’inizializzazione dell’applicazione che dev’essere eseguita quando il file 
viene caricato in memoria. 

Poiché, nel momento in cui scriviamo, geoProgrammer è l’unico pacchetto di 
programmazione GEOS compatibile presente in commercio, analizziamo un modo 
alternativo di creare applicazioni GEOS compatibili con qualsiasi compilatore. Il guaio 
è che i compilatori in commercio non sono in grado di creare il blocco File Header. Si 
possono utilizzare due stratagemmi per scavalcare il problema. Il primo consiste 
nell’utilizzare le routine di GEOS per salvare il file dalla memoria al disco. 
Sfortunatamente però, dal momento che GEOS inizializza la memoria a uno stato di 
default prima di eseguire l’applicazione, il programmatore dovrebbe caricare GEOS e 
poi trovare il modo di interrompere la sua esecuzione. Se successivamente riesce a 
trovare il modo di caricare l’applicazione in memoria, potrebbe includere nei suoi 
codici alcune chiamate alle routine del Kernel di GEOS per salvare l’applicazione su 
disco con il nuovo standard GEOS. Per farlo si può ricorrere a speciali unità hardware 
chiamate unità ICE (In-Circuit-Emulator). 

Fortunatamente possiamo trasformare il file PRG dell’applicazione nello standard 
GEOS in un altro modo. Questo prevede che il vostro compilatore salvi il file oggetto 
in memoria, nel formato normale PRG del C-64. Il File Header viene incluso come primo 
blocco del file oggetto, e quindi nel file sorgente si trova all’inizio, di modo che, quando 
è compilato, occupa esattamente il primo settore del file. Un programma Basic si 
preoccupa poi di prelevare il File Header, allocarlo su disco separatamente e 
riagganciare il resto del programma. Vediamo quali sono i dati contenuti nel blocco 
File Header e qual è il loro significato. 


Il blocco File Header 

Lo schema che segue nella pagina successiva mostra la struttura di un file in 
standard GEOS. Come normalmente accade, il File Entry in directory punta al primo 
blocco di dati del file. Rispetto al formato dei normali File Entry, il File Entry di un file 
GEOS compatibile contiene anche il puntatore al blocco File Header. In un normale file 
standard C-64, questi byte puntano al primo side-sector di un file relativo. Dal 
momento che GEOS non utilizza i file relativi, questi due byte sono disponibili per 
puntare al blocco File Header. 
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Struttura di base dei file GEOS compatibili 


File Entry 

l’indirizzo T/S del blocco 

File Header 

Blocco 

del 


File Header 

file 

W 



I byte 1 - 2 indicano l’indirizzo T/S 
del primo blocco del file 


Primo 
blocco 
del file 



Byte 0 -1 


I 

T/S blocco 
successivo 


Byte 0 -1 

I 


I 

T/S blocco 
successivo 


Secondo 
blocco 
del file 


Ultimo 
blocco 
del file 


Byte 0 -1 


T/S blocco 
successivo 



Byte 0 -1 
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Il trucco che utilizziamo per permettere al compilatore di salvare un file su disco in 
formato GEOS consiste neU'includere il blocco File Header come primo blocco del file. 
Dal momento che la memoria disponibile per le applicazioni in formato GEOS inizia 
all’indirizzo $0400, conviene scrivere il file sorgente dell'applicazione, compreso il File 
Header, in modo che il compilatore inizi a compilare i codici deU’applicazione a $0400. 
Dal momento che il primo blocco di un file su disco contiene l’indirizzo traccia e settore 
(T/S) del blocco successivo nei primi due byte, e nei due successivi l’indirizzo al quale 
allocarlo in memoria, sono disponibili solo 252 byte per il File Header, che deve 
occupare esattamente, le dimensioni di un blocco e non superarle. Quindi il 
compilatore deve iniziare a creare il file oggetto, comprendente il blocco File Header, 
a $0304 = $0400 - 252. In questo modo, quando il file è stato compilato e salvato su 
disco, il codice dell’applicazione inizia esattamente al secondo blocco ed è rilocato in 
maniera da risiedere a partire da $0400. 

I puntatori di caricamento e di esecuzione nel File Header sono entrambi impostati 
con l’indirizzo $0400, assumendo che la routine d’iniziaUzzeizione dell’appUcazione sia 
la prima routine dell’applicazione. Se non lo è, il puntatore di esecuzione dev’essere 
aggiornato di conseguenza. Creato il file sorgente, bisogna compilarlo e salvarlo su 
disco come un normale file PRG del C-64. Nel notes di deskTop appare con l’icona dei 
file C-64. Il blocco File Header si trova nel primo settore del file, mentre il codice 
dell’applicazione inizia dal secondo settore. 

II programma Basic che presentiamo nel prossimo capitolo, trasforma il file in un file 
GEOS. I byte 19 e 20 del File Entry in directory punteranno al blocco File Header, e 
i byte 1 e 2 punteranno al primo blocco dell’applicazione. A trasformazione avvenuta, 
l’icona associata al nuovo file apparirà in deskTop. Premendo il pulsante del mouse 
due volte sull’icona, si avrà il caricamento in memoria dell’applicazione all’indirizzo 
specificato nel File Header, e la sua esecuzione a partire dall’indirizzo d’esecuzione 
contenuto anch’esso nel File Header. La nostra applicazione sarà caricata a $0400 e 
mandata in esecuzione allo stesso indirizzo. 

Nel prossimo capitolo presenteremo prima di tutto la struttura sommaria del file da 
convertire e il progreunma Basic di trasformeizione in file GEOS. Il File Header è il primo 
blocco, seguito da due istruzioni fittizie per indicare l’inizio del codice dell’applicazio¬ 
ne. Una descrizione completa del File Header si trova nel capitolo dedicato ai file in 
ambiente GEOS. 





S PILE GEOS 

IN FORMATO PRO 


Introduzione 

La semplice applicazione che realizzeremo inizia a $0400, ed è preceduta da un 
gruppo di dati che costituisce il blocco File Header previsto da GEOS. Tale blocco di 
dati è lungo 252 byte; i restanti quattro che appariranno all’inizio del primo settore del 
file sul disco non sono riportati nel file sorgente. Questi quattro byte non possono 
essere impostati in fase di compilazione in quanto il compilatore li aggiorna in maniera 
autonoma. I primi due contengono Tindirizzo T/S del successivo blocco del file (oppure 
$00 seguito dal numero di byte del settore per individuare la fine del file), e questo 
formato, adottato per connettere sequenzialmente i blocchi di un file, viene impiegato 
anche in ambiente GEOS. Quando il programma Basic di conversione preleva il primo 
blocco del file per allocarlo separatamente come blocco File Header, questi due byte 
sono impostati rispettivamente a $00 e $FF, per indicare che non seguono altri blocchi 
di dati e tutti i byte del blocco corrente sono significativi. Gli altri due byte del primo 
blocco del file oggetto salvato su disco, ovvero la seconda coppia, contengono 
l’indirizzo al quale il file deve risiedere in memoria. Questa informazione non ha 
significato per il blocco File Header in se stesso, prima di tutto perché questo blocco 
non deve risiedere in un’area particolare di memoria, e in secondo luogo perché in 
ambiente GEOS l’indirizzo che individua l’area di memoria che dev’essere occupata 
da un file viene indicato altrove. Nel blocco File Header, anziché l’indirizzo, questi due 
byte contengono le dimensioni in altezza (21 pixel) e in larghezza (3 byte) dell’icona 
del file, che fortunatamente sono sempre le stesse. Quindi il programma Basic non 
incontra problemi per riscrivere questi due byte con le dimensioni 3 e 21 dell’icona. 

Il byte successivo nel blocco File Header contiene il numero di byte che definiscono 
il disegno dell’icona con il bit 7 impostato a 1 (il bit 7 è un flag di servizio per le routine 
di GEOS che disegnano le icone). Seguono 63 byte di dati grafici per definire il disegno 
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dell’icona. Dopo questo gruppo di dati, vi è un byte che contiene il tipo di file secondo 
lo standard C-64, che per le appliceizioni GEOS compatibili dev'essere USR, e un altro 
byte che indica il tipo secondo lo standard GEOS, che per la nostra applicazione è 
APPLICATION. Segue il tipo di struttura del file in standard GEOS, che per la nostra 
applicazione è SEQUENTIAL, i tre puntatori (ognuno di due byte) che indicano 
rispettivamente l’inizio e la fine del file in memoria, e l’indirizzo dove viene a risiedere 
la routine di inzializzazione dell’applicazione. Quindi troviamo il nome del file e il nome 
dell’autore. La struttura del blocco File Header è ampiamente illustrata nel capitolo 
dedicato al sistema dei file, dove affronteremo anche il significato dei dati in esso 
contenuti. 

U - 

TestApplication 

Chiamata da: deskTop 

Sinossi: Questo file contiene l’applicazione d’esempio. È scritto per essere 

compilato con un compilatore Assembly standard. I primi 252 byte di 
questo file contengono i dati che compongono il blocco File Header 
dell’applicazione e, a compilazione avvenuta, riempiranno interamente il 
primo blocco del file. Il file può essere convertito in standard GEOS 
utilizzando un programma Basic separato. 

Questo programma Basic separa il primo blocco del file oggetto 
dell’applicazione e lo alloca separatamente come File Header. Nel File Entry 
del file presente in directory, due byte contengono l’indirizzo traccia/settore 
del blocco File Header. I puntatori al primo blocco del file contenuti nel File 
Entry sono aggiornati con la traccia e il settore nel quale si trova il secondo 
blocco del file. In questo modo il primo blocco del file diventa il File Header 
e l’applicazione inizia con il codice oggetto. 


-99 

.psect $0304 ; indirizzo al <[uale deve inziare la compilazione del codice sorgente 

FileHeadert jl primi 4 byte come appaiono sul disco dopo che il file e' stato 

jtrasformato. Questi byte non sono presenti nel file sorgente 
;e quindi sono commentati a parte 

;,byte $00, $FF ;il File Header e' composto da un solo settore 

; je tutti i byte del settore sono significativi 

;.byte 3 ;ricona e' larga 3 byte 

j.byte 21 jl'icona e' alta 21 pixel 
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• byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.byte 
.word 
.word 
.word 

.byte 

.byte 

.byte 

.byte 

.byte 

.byte 

.byte 

.byte 

.block 


<63|$80) 

ninnili,umilili,v,iiiiiiii 
^ 10000000 .^ 000000001^08008001 
^ 10000000 .^ 00000000,^00000001 
^ 10000000.1^00000000.1^00000001 
^ 10011111 ,^ 11110000,^00000001 
^ 10000001 , :!! 00000000,%00000001 
^10000081, ^00000000, ^^00000001 
^ 10000001 ,^ 00011110,^00000001 
^ 10000001 ,^ 00100001,^00000001 
'^ 10000001 ,^ 00101110,^00000001 
'/. 10000001 , ^ 00100000,^00000001 
^ 10000001 ,^ 00011110,^00000001 
^ 10000001 , 1 ^ 00000000 , ^.00000001 
V . 10000001 , ^00011 111 , ^00100001 
^. 10000001 ,^ 00100000,^01111101 
^ 10000001 ,^ 00011110,:!00100001 
^ 10000001 , 1 : 00000001 , 1:00100001 
1 : 10000001 , 1 : 00111110 , 1:00011101 
1:10000008,1:00000000,1:00000001 
1:10000000,1:00000000,1:08000001 
1:11111111,1:11111111,1:11111111 

I80IUSR 

fiPPLICflTION 

SEQUENTIflL 

Loadflddress 

EndCode 

InitCode 


“Test Appi yi.0",0,0,0,0 
“Mike Farr",0,0,0,0,0,8,0,0,0,0,0 


0,0,0,0,0,0,0,0, 0,0 
0,0,0,0,0,0,0,0,0,0 
0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 
0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 
0 , 0,0 
0 

95 


;64 byte per definire il disegno dell'icona 


;tipo Commodore associato ai file GEOS 

;tipo GEOS associato al file 

)tipo struttura del file 

;indirizzo a cui allocare il file in memoria 

jindirizzo della fine del file in memoria 

; indirizzo dell'inizio del codice 

;deirapplicazione 

jl6 byte filename + 4 zeri 

j20 byte nome autore 0 , se file dati, nome 

jdisco dell'applicazione parente 

j20 byte nome applicazione parente 

; 

j23 byte liberi per le applicazioni 


jinizio del testo opzionale associato 
;al file, zero per nessun testo 
jspazio disponibile per il testo opzionale 
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Loadflddressi j$0400, i dati che iniziano a Loadflddress sono salvati su disco a partire 
jdal secondo blocco del file oggetto 

InitCodei jl'indirizzo InitCode dove risiede la routine d'inizializzazione 

jdell'applicazione non deve necessariamente corrispondere 
jfcorae invece avviene in questo caso) a Loadflddress 


Ida #0 jistruzioni fittizie per indicare l'inizio del codice 

sta r0L 


Il fUe Basic PRGTOGEOS 

In questo paragrafo parleremo del programma Basic che si utilizza per convertire un 
file PRG in un file GEOS. Per prima cosa il programma chiede in input il nome del file 
da convertire e la data. GEOS utilizza i byte dal 23 al 27 del File Entry per memorizzare 
sul programma la data dell’ultima modifica. Altri byte sono trasferiti dal blocco File 
Header al File Entry del file. Il formato del File Entry, modificato da GEOS, appare nella 
tavola seguente. 


Formato del File Entry dì un file 


Byte Descrizione 

0 Tipo C-64i 0=DELeted, l=SEQuential, 2=PRoGrar(i, 3=IJSeR, 

4=RELativa, Bit 6=1 file protetto 

1-2 Traccia e settore del primo blocco del file 

3-18 Nome del file di 16 caratteri. 11 nome e' riempito con gli spazi 

ottenuti con il tasto SHIFT (codice $fl0) 

19-20 Traccia e settore del blocco File Header 

21 Tipo struttura del file formato GEOS; 0=SEQuential, l=yLlR 

22 Tipo file formato GEOS; 8=NOT-GEOS, l=BflSIC, 2=flSSEMBLY, 

3=DflTfl, 4=SYSTEM, 5=DESK-flCC, 6=flPPLICflTI0N, 

7=flPPL-DflTfi, S=F0NT, 9=PRINTER, 10=INPIJT.OEVICE, 

11=D1SK-DEV1CE, . , 

23 Data; anno dell'ultima modifica, Solo le ultime due cifre 

24 Data; mese dell'ultima modifica (1-12) 

25 Data; giorno dell'ultima modifica (1-31) 

26 Data; ora dell'ultima modifica (8-23) 

27 Data; minuto dell'ultima modifica (0-59) 

28/29 Numero di blocchi (settori) occupati dal file 
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Il primo blocco del file da convertire memorizzato su disco contiene il File Header 
dell’applicazione. Questo programma converte il file in formato GEOS. 

Il nome del file da convertire viene richiesto in input e non può essere più lungo di 
16 caratteri. Ottenuta questa informazione, e la data, il programma cerca il file sul 
disco. 

Quando il file viene trovato, il programma ne separa il File Header (il primo blocco 
del file) e memorizza nell’apposito puntatore presente nel File Entry la traccia e il 
settore nel quale si trova. Il puntatore T/S contenuto nel File Entry per indicare il primo 
blocco del file è aggiornato per puntare alla traccia e al settore del secondo blocco del 
file (dove ha realmente inizio l’applicazione). 

I primi due byte del blocco File Header vengono cambiati in $00 e $FF e gli altri due 
in 3 e 21 (larghezza in byte e altezza in pixel dell’icona associata al file). 

I byte 21 e 22 nel File Entry vengono modificati per indicare rispettivamente il tipo 
di struttura e il tipo di file in ambiente GEOS. La data dell’ultima modifica è inserita 
nei byte dal 23 al 27. Il numero di blocchi del file non viene alterato. 


1000 

INPUT "NOME DEL PROGRfiMMfl"jFf 

1010 

IF F$='"' GOTO 1490 

■■ 


1020 

INPUT "ANNO 

(EX; 

88 )"jY 

1030 

INPUT “MESE 

(EXi 

5)"jM0 

1040 

INPUT "GIORNO 

(EX: 

31)"jDH 

1050 

INPUT “ORA 

(EX; 

14)“jH 

1060 

INPUT "MINUTI 

(EX: 

35)";MI 

1078 

OPEN 15, 8, 15, "1:0" 



1080 

OPEN 2, 8, 2, “#" 



1090 

T$=CHR$C18); S$=CHRf(l) 


1100 

GOSUe 1520 



1118 

GET*2, NTt, NS$ 



1120 

FOR E=0 TO 7 



1130 

GOSUB 1600 



1140 

IF D$=Ff GOTO 1180 



1150 

NEXT E 



1168 

IF NTt="" GOTO 1490 



1170 

Tt=NTti S$=NSti GOTO 

1100 


1180 

DT$=T$i DSt=S$ 



1190 

T$=HT$! S$=HS$: GOSUB 

1520 


1280 

GET#2, MTt, MS$ 



1210 

FOR 1=2 TO 67 




; input nome dell'applicazione 
jnome applicazione nullo, esci 
jinput data e ora 


jinizializza il drive 
japre un canale ad accesso diretto 
; traccia 18 settore li primo blocco 
ideila directory 

jcarica nel buffer un blocco della directory 
jpreleva la traccia e il settore del blocco 
; successivo 

icontrolla ogni File Entry 

Jpreleva il nome del file 

jse il nome del file corrisponde 

jdirectory terminata, nome non trovato, 
jesci 

jcarica il blocco successivo 
jil nome e' stato trovato 
jpreleva il blocco File Header 
jpreleva T/S per il secondo blocco 
jsalta al tipo di file del C-64 
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1220 

GET#2, B$ 


1230 

NEXT I 


1240 

GET#2, CTt, GT$, GF$ 

jpreleva CT$ - tipo file C-64, GT$ = tipo 
jfile GEOS, GF$ = struttura file GEOS 

1250 

GOSUB 1520 

jpreleva nuovamente il blocco File Header 

1260 

PRINT#2, CHR$(0)j CHR$(255)j 

jscrive $00 e IFF nei byte T/S 

1270 

PRINT#2, CHRI<3)j CHR$(21) ; 

;scrive 3,21 

1280 

GOSUB 1560 

^riscrive il blocco File Header 

1290 

T$=DTI: S$=DS$i GOSUB 1520 

jpreleva il blocco della directory 
jche contiene il File Entry del file 

1300 

FOR 1=0 TO 32*6+1 

jsalta al File Entry numerato da E 

1310 

GET#2, B$ 


1320 

NEXT I 


1330 

IF MS$=''" THEN MS=0! GOTO 1350 

jse il settore e' 0 l'istruzione ascO da' 

jerrore 

1340 

l1S=flSC(l1S$) 


1350 

PRINT#2, CT$; MT$; CHRKIIS); 

jmemorizza il tipo C-64 e il puntatore T/S 
jdel primo blocco utile del file (il secondo 
jblocco) nel File Entry 

1360 

FOR 1 = 1 TO 16 

jsalta alla T/S del File Header 

1370 

GET#2, B$ 


1380 

NEXT I 


1390 

IF HS$="" THEN HS=0i GOTO 1410 


1400 

HS=flSC(HS$) 


1410 

IF GF$=““ THEN GF=0; GOTO 1430 


1420 

GF=fìSC<GF$) 


1430 

IF GT$=“" THEN GT=0i GOTO 1450 


1440 

GT=flSC<GT$> 


1450 

PRINT#2,HT$iCHR$(HS);CHR$(GF)jCHR$(GT); jmemorizza T/S del File Header, 

jstruttura GEOS dèi file (VLIR 
;o SEQ>, il tipo file GEOS 

1460 

PRINT#2,CHR$(Y);CHR$(l10);CHRf(0fl); 

jmemorizza la data 

1470 

PRINT#2,CHR$(H);CHRt(«I); 

jmemorizza l'ora 

1480 

GOSUB 1560 

jriscrive il File Header su disco 

1490 

CLOSE 2 


1500 

CLOSE 15 


1510 

END 


1520 

IF S$="" THEN SE=0; GOTO 1540 


1530 » 

SE=flSC<S$) 


1540 

PRINT#15, "Ul“; 2; 0; flSCCTI); SE 

jsubroutine per prelevare un blocco dal disco 

1550 

RETURN 


1560 

IF S*=“" THEN SE=0i GOTO 1580 
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1570 

SE=flSC(S$) 


1580 

PRINT#15, "U2"; 2; 0; flSC(T$); SE 

;subroutine per scrivere un blocco sul disco 

1590 

RETURN 


1600 

REM 

jsubroutine per cercare il nome del file 

1610 

D$=““ 

jinizializza il nome del file 

1620 

GET#2, B$: 1 = 1 

^preleva il primo carattere, inizializza I 

1630 

IF B$="" GOTO 1690 

jFile Entry nullo 

1640 

IF fiSC(BJ) <> 130 GOTO 1690 

jse il tipo non e' PRG allora vai 
;alla riga 1698 

1650 

GET#2, HT$, HS$i 1=3 

;T/S del primo blocco del file 
;<il File Header) 

1660 

GET#2, B*i 1 = 1 + 1 

jpreleva un carattere dal nome del file 

1670 

IF flSC<B»)=160 GOTO 1690 

;se e' alla fine del nome salta al prossimo 
jFile Entry 

1680 

D$=D$+B$i GOTO 1660 

^preleva il successivo carattere del nome 

1690 

FOR I = I TO 31 

;salta il File Entry corrente 

1700 

GET#2, B$ 


1710 

NEXT I 


1720 

RETURN 



Pronti alla creazione di un file GEOS 

A questo punto il programmatore possiede gli strumenti di lavoro fondamentali per 
realizzare una semplice applicazione come quella che vi proponiamo. È importante 
effettuare qualche prova di conversione di file PRG, in maniera da familiarizzarsi con 
questa operazione. Il nostro consiglio è di iniziare a scrivere, compilare e trasformare 
un’applicazione molto semplice, e approfondire un po' alla volta le caratteristiche 
offerte da GEOS inserendole in nuove versioni più complesse della nostra applicazione. 

Ognuno dei prossimi capitoli tratterà un argomento specifico. Dopo averli letti e 
approfonditi, il programmatore dovrebbe fare qualche piccola esperienza aggiungendo 
funzioni al piccolo programma che stiamo per descrivere. In questo modo, procedendo 
nella lettura del libro, si acquisisce gradualmente familiarità con il sistema nei suoi 
molteplici aspetti. 


n file QuantumTest 

Questa applicazione si propone di illustrare la gestione dei menu e delle icone. 


.include geosConstants 
.include geosMeitoryHap 


;sii(iboli delle costanti 
jsiiifiboli delle variabili 
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.include geosRoutines 
.include geosHacros 


^simboli delle routine 

jfile contenente le inacro istruzioni 

{Utilizzate nella compilazione 


USE-PRGTOGEOS = 1 


,if USE-PRGTOGEOS 


■psect $0304 


{flag di compilazione per indicare se viene usato 
{<valore 1) o non viene usato (valore 0) il programma 
jPRGTOGEOS di conversione 

;se il valore del flag e' 1 il primo blocco del 
{file e' il File Header associato 

;il testo viene compilato a partire da questo indirizzo 


U _ 

Il blocco File Header dell’applicazione 

Sinossi: Il blocco File Header contiene varie informazioni associate al file. Fra queste 

assumono particolare importanza l’indirizzo di allocazione in memoria, 
l’indirizzo di esecuzione, il nome del file e il disegno dell’icona associata. 

Se si adotta il metodo di trasformazione del file PRG in ^QUENTIAL 
standard GEOS, impiegando il programma Basic PRGTOGEOS, i dati che 
compongono il File Header devono, a compitazione avvenuta, occupare 
interamente il primo blocco del file oggetto. I primi quattro byte sono 
commentati a parte (xime si spiega nell’introduzione al capitolo. 
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FileHeader: {inizio dei dati che costituiscono il blocco File Header 

{.bgte $00,$FF {il File Header e' composto da un solo settore 

{.byte 3 {l'icona e' larga 3 byte 

{.byte 21 {l'icona e' alta 21 pixel 


.byte (63|$80) {64 byte per definire il disegno dell'icona 
• byte Xllllllll, umilili, 5:11111111 

. by te 5:10000000,5:00000000, '400000001 

. byte 5:10000000,5J00000000,5'00000081 

. byte 5:10000000,5;00000000,5:00000001 

. byte 5:10011111,5:1111 0000 , '400000001 
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. byte ^10000001,X00000000,X00000001 

.byte ^10000001,1^00000000.^00000001 

.byte ^10000001,1^00011110,^00000001 

.byte ^10000001, ’/Mimm, 1^00000001 

.byte X10000001,^00101110,^00000001 

.byte X10000001,^00100000,X00000001 

.byte ^10000001,‘/.0e0i 1110,1:00000001 

.byte ^10000001,1:00000000,1:00000001 

.byte 1:10000001, 1 : 0001 1111, 1:00100001 

.byte 1 : 10000001 ,1:00100000,1:01111101 

.byte 1:10060001,1:00011110,1:00100001 

.byte 1 : 10000001 , 1 : 00000001 , 1:00100001 

.byte 1 : 10000001 , 1 : 00111110 , 1:00011101 

.byte 1 : 10000000 , 1 : 00000000 , 1:00000001 

. byte 1 : 10000000 ,1:00000000,1:60000001 

• byte 1 : 11111111 , 1 : 11111111 , 1:11111111 

.byte I80|USR 

■byte fiPPLICflTION 

.byte SEQUENTIflL 

.word QuantunTest 

.word EndCode 

.word InitCode 

.byte “Quantum VI.0", 0 , 0 ,6,6 

.byte “Mike Farr", 0 , 0 , 0 , 0 , 0 , 0 ,0,0,0,6,0 

.byte 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 

.byte 0 , 0 , 0 , 0 ,0,0, 0 , 0 , 0,0 

.byte 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0 , 0,0 

.byte 0 , 0 ,0,0,0,0,0,0,0,0 

.byte 0,0,0 

.byte 0 

.block 95 


.else 


.psect 10400 


.endif 


jtipo Commodore associato ai file GEOS 

jtipo GEOS associato al file 

; tipo struttura del file 

jindirizzo ove locare il file in memoria 

;indirizzo della fine del file in memoria 

;indirizzo dell'inizio del codice 

;dell'applicazione 

jl6 byte filenaroe + 4 zeri 

,'20 byte nome autore 

;20 byte nome applicazione parente 

! 

;23 byte liberi per l'applicazione 


; inizio del testo opzionale associato 
;al file, zero per nessun testo 
ispazio disponibile per il testo opzionale 


;fine del blocco File Header 


)nel caso non venga impiegato il programma 
;PRGT0GE0S, il codice oggetto deve iniziare 
ja *0400 
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File GEOS di dimostrazione Quantum Link. Routine principale 

Autore: Mike Farr 

Chiamata da: desklop 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: Orientativamente, tutti i registri 

Sinossi: Questo modulo contiene alcune routine atte a verificare il funzionamento di 

menu e icone. Quando un file è mandato in esecuzione da deskTop, il 
controllo del sistema viene ceduto aH’indirizzo indicato dalla label InitCode. 
L’applicazione definisce e visualizza il primo schermo utilizzando le 
appropriate routine. 

li primo schermo mostra otto icone (corrispondenti a otto voci del menu 
principale della rete Q-link). I disegni delle icone possono essere di 
qualunque dimensione. Le piccole icone che utilizziamo in questa 
applicazione sono tratte dall’applicazione geoPaint e in effetti sono un po’ 
piccole per uno schermo iniziale. 

Tutte le icone visualizzate sul primo schermo eseguono la stessa routine 
di servizio. Quando una viene attivata, la routine di servizio cancella lo 
schermo corrente e visualizza la struttura del menu principale del secondo 
schermo. 

Il secondo schermo mostra la struttura di un menu come potrebbe 
apparire nella rete Q-link. I nomi che compaiono nelle voci dei menu 
possono essere sostituiti da qualsiasi parola o frase significativa per 
l’utente, e tutte le voci dei sotto-menu chiamano la stessa routine di servizio. 
Questa routine comune a tutte le voci, non fa altro che chiamare la routine 
di sistema GotoFirstMenu per lasciare attivato solo il menu principale e 
disattivare tutta la struttura di sotto-menu correntemente aperta. 

L’icona nella parte bassa a sinistra del secondo schermo restituisce il 
controllo a deskTop, e quindi determina la conclusione dell’applicazione. 


99 
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QuantumTesti 


jinizio codice dell'applicazione 

InitCode: 


jroutine principale attivata per eseguire 




; l'applicazione 


jsr 

NeuOisk 

jun bug presente in precedenti versioni 
jdi GEOS rende necessario chiamare NeuDisk 
;per fermare il motorino di rotazione del 




;disco se l'applicazione non accede al drive 


Jsr 

MouseUp 

;attiva il mouse (inutile se e' già' attivato) 


Ida 

*2 



jsr 

SetPattern 

(■imposta la matrice grafica punteggiata al 


jsr 

i-Rectangle 

;cancella lo schermo riempiendolo con 
;la matrice grafica prescelta 

.byte 

e 



.byte 

199 



.byte 

8 



.byte 

319 




LoadN 

r0, QuantumTestIcons 

indirizzo della tavola di dati che 




;definisce le icone da visualizzare 


jsr 

Dolcons 

jdefinisce le icone 


rts 




44 _ 

Tavola di definizione deile icone 


Chiamata da: 

Parametri: 

Restituisce: 

Sinossi: 


La routine principale QuantumTest cede il controllo della tavola di 
definizione a MainLoop tramite la chiamata alla routine Dolcons. 

Nessuno 

Niente 

La tavola definisce le otto icone del primo schermo. 


99 
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Y-POS-TOP-ICON = 10 

;le coordinate x e y sono sisurate dairangolo sinistro 



;in alto delio scherno,e individuano senpre l'angolo 



.;superiore sinistro dell'icona 


X-POS-TOP-ICON = 3 



QuantuaTestlcons! 



.byte 

8 

; numero di icone 


■ word 

160 

;codrdinata:x deila posiiione del nouse dopo 




jla visualizzazione delle icone 


.byte 

100 

scoordinata y della posizione del nouse dopo 
sla visualizzazione delle icone 


.word 

showCaseData 

spuntatore ai dati grafici per l'icona showCase 


.byte 

X-POS-TOP-ICON 

scoordinata x in byte dell'icona 


.byte 

Y-POS-TOP-ICON 

scoordinata y in pixel dell'icona 


.byte 

2, 16 

slarghezza in byte e altezza in pixel dell'icona 


.word 

DoShow 

Sroutine di servizio per l'icona showCase 


.word 

JustForFunData 

spuntatore ai dati grafici perTicona hand 


.byte 

X-POS-TOP-ICOH 

scoordinata x in byte dell'icona 


.byte 

Y-POS-TOP-ICON+30 

scoordinata y in pixel dell'icona 


.byte 

2, 16 

slarghezza in byte e altezza in pixel dell'icona 


.uord 

DoFun 

sroutine di servizio per l'icona hand 


.uord 

custServData 

spuntatore ai dati grafici per l'icona eraser 


.byte 

X-POS-TOP-ICON 

scoordinata x in byte dell'icona 


.byte 

Y-POS-TOP-ICON+60 

scoordinata y in pixel dell'icona 


.byte 

Z, 16 

slarghezza in byte e altezza in pixel dell'icona 


.word 

DoServ 

sroutine di servizio per l'icona eraser 




somettiano i commenti per i gruppi di definizione 

delle ul 



stime cin<iue icone, in quanto la struttura rimane 

identica 

.word 

mallData 



.byte 

X-POS-TOP-ICON+15 



.byte 

Y-POS-TOP-ICON+60 



.byte 

Z, 16 



.word 

Donali 
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.word 

newsData 

.byte 

X-POS-TOP-ICON+30 

.byte 

Y.POS-TOP-ICON+60 

.byte 

2, 16 

.word 

DoNews 

.word 

learningData 

.byte 

X-POS-TOP-ICON+30 

.byte 

Y-POS-TOP-ICON+30 

.byte 

2, 16 

.word 

OoLearn 

.word 

cinData 

.byte 

X-prjS-TOP-ICON+30 

.byte 

Y-POS-TOP-ICON 

.byte 

2; 16 

.word 

DoCin 

.word 

pConData 

.byte 

X-POS-TOP-ICON+15 

.byte 

Y-POS-TOP-ICON 

.byte 

2, 16 

.word 

DoPCon 

44 . 



Routine di servizio per le icone del primo schermo 


Chiamata da: Attivazione delle icone del primo schermo. 

Parametri: Nessuno 

Restituisce: Niente 


Sinossi: Attivando una delle icone del primo schermo, viene eseguita la routine di 

servizio associata. Nel nostro esempio tutte le icone del primo schermo 
eseguono la stessa routine di servizio, che cancella lo schermo corrente e 
attiva il successivo. 




DoShow; 


; routine di servizio per l'icona 
jCottiiiiodore Software Showcase 
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DoFuni 

; routine 

di 

servizio 

per 

1'icona 

Just For Fun 

DoServ: 

; routine 

di 

servizio 

per 

1'icona 

Customer Service Center 

Donali 1 

j routine 

di 

servizio 

per 

1'icona 

The Mail 

DoNewsi 

; routine 

di 

servizio 

per 

1'icona 

News and Information 

DoLearni 

; routine 

di 

servizio 

per 

1'icona 

Learning Center 

DoCini 

)routine 
;Netuork 

di 

servizio 

per 

1'icona 

Commodore Information 

DoPCon: 

; routine 

di 

servizio 

per 

1'icona 

People Connection 


jsr i-Rectangle ; cancella lo schermo 

.byte 0 
.byte 199 
.word 0 
.word 319 

LoadW r0, ScreenZIcon 
jsr Dolcons 


Ida #0 

LoadW r0, QuantumTestMenu 
jsr DoMenu 

rts 

44 - 

Dati grafici deiie icone dei primo schermo 

Sinossi: Queste icone sono state tratte dall'applicazione geoPaint. 


jindirizzo della tavola di definizione dell'icona 
;presente sullo schermo 

jattiva le icone, Per via di un bug presente in GEOS, 
jdev'essere definita (ma non necessariamente 
jvisualizzata) almeno un'icona 
jposiziona il mouse sulla prima voce del menu 
; indirizzo della tavola di definizione dei menu 
jdefinisce i menu 
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showCaseData; 

.byte $02,$FF,$9C,$80,$01,t80,t39,$80,$6O,$80,$E5,*81,$BD,$83,$19,$8€ 
.byte $31,$8C,t61,$98,$Cl,tBl,$81,fBB,t01,tBE,$01,$BC,l01,$80,l01,t02 
.byte IFF 
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justForFunOata; 

.byte $02,$FF,$9C,$87,$01,$8D,l81,l9E,ICl,$BB,$61,»flD,$Bl,$86,$99;$9B 
•byte $09,$9D,$0D,$96,$07,$9fi,$03,*8C,t01,$87,»El,$80,l31,$80,$19,*02 
.byte tFF 
custServData; 

.byte $02,$FF,»9C,$80,$81,$80,f01,$BF,»01,$BF,$81,IBF,$Cl,$flF,$EMfl7 
.byte tFl,IB3,$Fl,$9fl,lll,$8E,$ll,t86,fll,»83,$Fl,»80,l01,$80,$01,$02 
.byte $FF 
nallData: 

.byte $02,$FF,$9C,$80,$01,*80,*01,I83,*81,$83,»81,I86,$C1;$86,$C1,$84 
.byte $C1,18C, $61, t88,$61,$8F,$E1,$98,$31,$90;$31,$B8,$79,180.101,102 
.byte $FF 
neusData; 

.byte $62,$FF,$8E,$80,$01,$80,$01,$90,$01,$98,$01,$8C,$01,$86,$01,$83 
.byte $01,$02,$81,$8C,$80,$C1,$80,$61,$80,$31,$80,$19,$80,$09,$80,$01 

.byte $FF 
learningOata: 

.byte $02,$FF,$9C,$80,$01,$80,$01,$9D,$B9,$90,$09,$90,$09,$80,$01,$90 
.byte $09, $90, $09, $80,$01,$90,$09,$90,$09,$90,$B9,$80,$01,$80,$01,$02 

.byte $FF 
cinData! 

.byte $02,$FF,$9C,$80,$01,$80,$01,$9D,$B9,$90,$09,$90,$09,$80,$01,$90 
.byte $09,$90,$09,$80,$01,$90,$09,$90,$09,$90,$B9,$80,$01,$80,$01,$02 

.byte $FF 
pConOata: 

.byte $02,$FF,$9C,$80,$01,$80,$01,$9O,$B9,$90,$09,$90,$09,$80,$81,$90 
.byte $09, $90,$09,$80,$01,$90,$09,$90,$09,$90,$B9,$80,$01,$80,$01,$02 
.byte $FF 

U- 

Tavola di definizione dell’icona dei secondo schermo 

Chiamata da: Viene utilizzata dalla routine Dolcons che a sua volta viene eseguita dalla 
routine di servizio associata alle icone del primo schermo. 

Sinossi: Definisce l’icona nell’angolo inferiore sinistro delio schermo la cui selezione 

termina l’esecuzione dell’applicazione e ricarica deskTop. 
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Screen2Icon; 


• byte 

1 

.uord 

240 

.byte 

155 

.word 

shouCaseData 

.byte 

30 

.byte 

150 

.byte 

2, 16 

.word 

ReturnDeskTop 


)numero di icone 

;coordineta x del mouse una volta definita l'icona 

{coordinata y del mouse una volta definita l'icona 

{Utilizza nuovamente i dati grafici dell'icona shouCase 

{coordinata x in byte dell'icona 

{Coordinata y in pixel dell'icona 

{larghezza in byte e altezza in pixel dell'icona 

{routine di servizio associata per terminare l'applicazione 


ReturnDeskTopi 

jffip EnterDeskTop {termina l'applicazione ritornando a deskTop 


U_ 

Struttura del menu dei secondo schermo 
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MfìlN-TOP 

= 10 


MfllN-BOT 

= 24 

{altezza del menu orizzontale principale 
{corrispondente all'altezza di una linea di testo 

MfìlN-LFT 

= 0 


MfllN-RT 

= 255 

{valore da determinare sperimentalmente (impostato 
{per un menu di dimensione orizzontale massima) 

QuantumTestMenu; 


.byte 

MfllN-TOP 

{posizione del lato superiore del menu 

.byte 

tIflIN-BOT 

{posizione del lato inferiore del menu 

.word 

MfllN-LFT 

{posizione del lato sinistro del menu 

.word 

MfllN-RT 

{posizione del lato destro del menu 

.byte 

H0RIZ0NTftL|2 

{tipo di menu OR'ed con il numero di voci di cui 
{e' composto 

.word 

changeDeptText 

{indirizzo della stringa di testo per questa voce 

.byte 

SUB-MENU 

{flag per indicare che la voce attiva un sotto-menu 

.word 

ChangeDeptMenu 

{indirizzo della struttura del sotto-menu 

.word 

showCaseText 

{indirizzo della stringa di testo per questa voce 
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•byte SUB-MENU 
•word ShowCaseMenu 


jflag per indicare che la voce attiva un sotto-menu 
;iridirizzo della struttura del sotto-menu 


44_ 

Testi per le voci del menu principale 
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changeDeptTexti 
showCaseText ; 


■byte "Change Departments"j8 

.byte "Commodore Software Showcase'SB 


; testo per questa voce 
Mesto per questa voce 


U- 

Tavola di definizione dei sotto-menu “Change Departments” 

Chiamata da: Sotto-menu attivato dalla voce “Change Departments” del menu principale 
del secondo schermo. 

Voci del menu: Commodore Software Showcase The Mail 

Just For Fun Commodore Information Network 

Customer Service Center Learning Center 

People Connection News and Information 
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ChangeDeptMenui 
.byte MfllN-BOT 

.byte l1fiIN-B0T+(8tl4)-Fl 

.word MflIN-LFT 
.word llfiIN-LFT+155 
.byte VERTlCflLlS 

.word ShowcaseText 


)il lato superiore del sotto-menu inizia in corrispon- 

idenza del lato inferiore del menu principale 

)il lato inferiore del sotto-menuj e' ottenuto calcolando 

;14 pixel verticali per ogni voce, piu' uno finale 

;lato sinistro del sotto-menu 

;lato destro del sotto-menu 

jtipo menu OR'ed con il numero di voci 

;puntatore (per questa voce) alla stringa già' 
jprecedentemente inserita nel file sorgente 
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ChangeOeptHenu! 


.byte 

HflIH-BOT 

;iriato superiore del sotto-aenu inizia in corrispondenza 
idei lato inferiore del aenu principale 

.byte 

MflIN-B0T+(8*14)+l 

;il lato inferiore del sotto-aenu, e' ottenuto calcolando 
;14 pixel verticali per ogni voce, piu' uno finale 

.word 

HflllLLFT 

Uato sinistro del sotto-aenu 

.word 

HflIN-LFT+155 

;lato destro del sotto-aenu 

.byte 

VERTICflL|8 

;tipo aenu OH'u) con il nuaero di voci 

.word 

showcaseText 

;puntatore (per guasta voce) alla stringa 
jgia' definita 
;precedenteaente definita 

.byte 

«ENU-fiCTION 

;flag per indicare una routine di servizio 

.word 

ShowcaseDsp 

{indirizzo della routine di servizio associata 

.word 

funText 

{puntatore alla stringa per guasta voce 

.byte 

HEHULfICTION 

{flag per indicare una routine di servizio 

.word 

funOsp 

{indirizzo della routine di servizio associata 

{per i gruppi di definizione delle ultiee sei voci 
{del sotto-aenu, oaettiaao i coaaenti 

.word 

serviceText 


.byte 

«ENO-flCTION 


.word 

ServiceDsp 


.word 

peopleConText 


.byte 

MEHU-flCTIOH 


.word 

PeopleConDsp 


.word 

KallText 


■ byte 

HENU-flCTION 


.word 

HallDsp 


.word 

infoHetText 


.byte 

nENlLACTION 


.word 

InfoNetDsp 


.word 

learningText 


.byte 

«ENUJÌCTION 


.word 

LearningOsp 
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.uord neusText 
■byte MENU-flCTION 
■uord NeusDsp 

U _ 

Tavola di definizione del aotto-menu “Software Showcase” 

Chiamata da: Sotto-menu attivato dalla voce “Commodore Software Showcase" del menu 
principale del secondo schermo. 

Voci del Menu: Software Catalog Software Previews 

SIG Software Library Person-to-Person File Transfer 

Software Reviews Q-Link Post Office 

Change To Another Department 
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ShoucaseMenui 

.byte MflIN-BOT ;lato superiore del sotto-menu 

.byte MflIN_B0T+(7t:14> + l jlato inferiore del sotto-menu calcolato per sette voci 

.uord 94 jlato sinistro del sotto-menu verticale 

.uord 94-H40 jlato destro del sotto-menu verticale 

.byte C0NSTRflINED|UERTlCfìL|7 jtipo di sotto-menu e numero voci. CONSTRfllNED 

jsignifica che il mouse può' uscire solo dal lato 
jsuperiore del sotto-menu 

jindirizzo del testo per questa voce 
jla prossima uord indica l'indirizzo della routine 
jdi servizio 

jroutine di servizio per questa voce 


.uord catalogText 
.byte MENU-flCTION 

.uord CatalogDsp 


jper i prossimi sei gruppi di definizione delle voci, 
jomettiamo i commenti in quanto la loro struttura 
jnon cambia 


.uord previeuText 
.byte MENU-flCTION 
,uord PrevieuDsp 


.uord sIGLibText 
.byte MENU-flCTION 
.uord SIGLibOsp 
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.uord 

fileTransText 

.byte 

MENU-ftCTION 

.word 

FileTransDsp 

.word 

reviewText 

.byte 

MENU-flCTION 

.word 

ReviewDsp 

.word 

postOfficeText 

.byte 

MENU-flCTION 

.word 

PostOfficeOsp 

.word 

changeText 

.byte 

MENU-flCTION 

.word 

ChangeDsp 


44 _ 

Testo per le vad del sotto-menu "Change Departments" 
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learningText! 

.byte 

“Learning Center",0 

funText; 

.byte 

'‘JustForFun",0 

serviceTexti 

.byte 

"Customer Service Center”,0 

infoNetText i 

.byte 

“Cofflfflodore Information Network",0 

peopIeConText: 

.byte 

"People Connection",0 

newsText t 

.byte 

"News and Informaiion",0 

mallText i 

.byte 

"The Mair',0 


44 _ 

Testo per le vod del sotto-menu ‘Commodore Showcase” 



FILE GEOS IN FORMATO PRG 


71 


catalogText ; 

,bgte 

"Software Catalog"j0 

previewText i 

.byte 

"Software Previews",0 

sIGLibText i 

.byte 

"SIG Software Library",0 

fileTransText ! 

.byte 

"Person-to-Person File Transfer",0 

reviewText; 

.byte 

"Software Reviews",0 

postOfficeText 1 

.byte 

"0-Lirik Post Office",0 

changeText ! 

.byte 

"Change to Pinot he r Dept.",0 


U _ 

Routine di servizio per le voci dei sotto-menu “Software Showcase” 
e “Change Departments” 

Chiamata da: Dalle voci dei sotto-menu “Software Showcase” e “Change Departments”. 
Sinossi: Routine di servizio fittizia per tutte le voci dei sotto-menu. 

- 

LearningDsp; jRoutine di servizio per il sotto-rfienu "Change Departrnerits” 

FunDspi 

■ServiceDsp! 

InfoNetDsp; 

F'eopleConDspi 

NewsDspi 

tlallDsp; 

CatalogDspi jRoutine di servizio per il sotto-menu "Software Showcase" 

F'reviewDsp i 
SlGLibDspi 
FileTransDspi 
ReviewDsp; 

PostOfficeDspi 

ChangeDspi 

ShowcaseDspi 

jsr GotoFirstMenu jchiude i sotto-menu 
rts 


EndCodei 


;fine deH'applicazione 





GEOS 

E LA GRAFICA 


Introduzione 

Gli argomenti che abbiamo trattato finora sono sufficienti per creare piccole 
applicazioni e salvarle su disco in file GEOS. È quindi arrivato il momento di parlare 
delle nuove risorse offerte da GEOS al programmatore, e dare così maggior consistenza 
alle applicazioni. In questo capitolo scopriamo quali sono le opportunità grafiche 
disponibili in ambiente GEOS. Come è già stato accennato, GEOS utilizza uno schermo 
grafico realizzato con il modo bit-map in alta risoluzione installato nel C-64. Non ci 
soffermeremo a illustrare questo modo grafico, probabilmente già noto a tutti. 

Disegnare sullo schermo di GEOS significa impostare a 1, o a 0, i bit della RAM 
impiegata per definire lo schermo in alta risoluzione. 1 bit impostati a 1 sono 
visualizzati con il colore di “foreground”, ovvero il colore del tratto, mentre quelli 
impostati a 0 sono visualizzati con il colore di “background”, cioè il colore di fondo. I 
colori di default in ambiente GEOS sono grigio scuro per il tratto e grigio chiaro per 
lo sfondo. Questa scelta può apparire insolita dal momento che si è portati a pensare 
che lo schermo privo di disegni debba essere nero. In realtà questa combinazione di 
colori nasce dal desiderio di offrire un’interfaccia utente che abbia le sembianze di un 
foglio di carta bianco sul quale si scrive con una penna nera. In ambiente GEOS lo 
sfondo vuole essere un foglio bianco e i tratti sono realizzati con una penna nera. Questi 
colori possono essere cambiati ricorrendo al desk accessory Preference Manager, e 
quindi risulta più comodo e chiaro parlare di colore di primo piano, o del tratto, e colore 
di fondo. 
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Le dimensioni geometriche 

Tutte le dimensioni geometriche passate alle routine di gestione della grafica sono 
inclusive. Con questo termine intendiamo dire che, per esempio, una linea disegnata 
grazie a informazioni sulle coordinate di due punti sullo schermo, comprende anche 
il punto d’inizio e il punto d’arrivo, e un rettangolo, come vedremo più avanti, include 
le linee del bordo. 


I colori 

Se si desidera gestire in maniera articolata anche i colori, bisogna tener conto delle 
restrizioni imposte dal sistema di gestione dei colori in bit-map del C-64. Nel momento 
in cui scriviamo, tutte le routine grafiche disponibili in GEOS non hanno effetto sulla 
pagina del colore associata allo schermo in bit-map. Quindi qualsiasi figura disegnata 
con le routine grafiche utilizza solo il colore del tratto e il colore di fondo. È compito 
dell’applicazione manipolare i colori e predisporre, se necessario, 1000 byte per 
mantenere una copia della pagina del colore perché ci sia la possibilità di realizzare 
l’opzione Undo. Questa gestione dei colori autonoma, cioè indipendente dalle routine 
grafiche di GEQS, è per esempio realizzata nell’applicazione geoPaint. 


Il buffer di schermo 

Come già brevemente illustrato nel primo capitolo, GEQS gestisce un secondo 
schermo allocando 8000 byte in un buffer di schermo. Questo buffer è utilizzato per 
copiare i contenuti dello schermo principale e per conservarli in caso di necessità. Per 
esempio, all’apertura di un menu la parte di schermo coperta viene momentaneamente 
salvata nel buffer di schermo, e alla chiusura del menu viene riallocata sullo schermo 
originale per ripristinare i disegni precedentemente coperti. Un altro impiego del 
buffer di schermo può essere la realizzazione da parte delle applicazioni della funzione 
Undo. Se non si desidera salvare momentaneamente parti dello schermo principale, 
si può disabilitare l’uso del buffer di schermo e utilizzare per altri scopi l’area di 
memoria rimasta disponibile. Ripristinare una parte dello schermo precedentemente 
salvata significa copiare una particolare area dal buffer allo schermo principale. 

GEQS prevede un flag per indicare se tutte le operazioni grafiche eseguite 
dall’applicazione (disegni e testi) devono essere effettuate sia sullo schermo principale 
sia nel buffer di schermo, oppure solo sullo schermo principale o solo nel buffer di 
schermo. Il nome di questo flag è dispBufferQn. GEQS accede ai bit 6 e 7 di tale byte 
per determinare la configurazione dello schermo: 


dispBufferOn 


bit 7 - se impostato a 1 scrive sullo schermo principale 
bit 6 - se impostato a 1 scrive nel buffer di schermo 
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Le routine grafiche, come quelle per il disegno di linee che analizzeremo fra poco, 
per eseguire i loro compiti fanno riferimento al valore contenuto nel flag dispBufferOn. 
Il modo più comune per impiegare dispBufferOn, consiste nel limitare il disegno di una 
forma geometrica allo schermo principale e utilizzare il contenuto precedente del 
buffer di schermo per cancellarla. Lo stesso GEOS ricorre a questa tecnica per gestire 
i menu e i box di dialogo. Il menu viene disegnato solo sullo schermo principale, e 
quando l'utente lo chiude GEOS lo cancella copiando una parte del buffer di schermo 
sullo schermo principale. GEOS supporta routine specifiche per trasferire parti dello 
schermo principale nel buffer di schermo e viceversa. 

Alcune applicazioni che necessitano di una maggiore quantità di memoria, possono 
destinare gli 8K del buffer di schermo a contenere i loro codici e i dati. Ma in questo 
modo sorge il problema di come gestire i menu, i box di dialogo e i desk accessory. 
Dev’essere l’applicazione, allora, a provvedere autonomamente ed ripristino dello 
schermo ogni volta che occorre. 

GEOS prevede un vettore, recoverVector, che normalmente contiene l’indirizzo della 
routine grafica RecoverRectangle (la vedremo più avanti). Ogni volta che GEOS deve 
ripristinare lo schermo coperto da un menu, un box di dialogo o un desk accessory, 
prepara dei parametri per indicare le dimensioni del rettangolo da copiare dal buffer 
sullo schermo principale. Questi parametri serviranno alla routine RecoverRectangle, 
che GEOS chiama attraverso il vettore recoverVector. Se l’applicazione utilizza per altri 
scopi la memoria destinata di solito al buffer di schermo, allora deve smche provvedere 
aU’aggiornamento di recoverVector con l’indirizzo della routine appositamente creata 
per ripristinare lo schermo. 

Se l’applicazione memorizza nel vettore recoverVector l’indirizzo di una routine 
propria, questa potrà accedere a tutti i parametri che normalmente GEOS prepara per 
la routine RecoverRectangle. Quindi se un’applicazione utilizza il buffer di schermo per 
impieghi particolari, deve prevedere una routine in grado, all’occorrenza, di 
ripristinare lo schermo. 


11 disegno delle linee 

Iniziamo ad approfondire le capacità grafiche di GEOS illustrando la forma più 
semplice di disegno: la linea. Prima di proseguire è bene distinguere le linee verticali 
e orizzontali da quelle diagonali, dal momento che il modo di trattarle è 
sostanzialmente diverso. Le linee orizzontali e verticali possono essere disegnate 
secondo una matrice grafica di riferimento, cioè non devono essere necessariamente 
continue, mentre le linee diagonali lo sono sempre. 

Quando GEOS disegna una linea orizzontale, il byte che rappresenta la matrice 
grafica, o di continuità, della linea viene ripetutamente memorizzato nei byte della 
RAM che contengono lo schermo grafico. Ogni matrice grafica copre esattamente un 
byte della memoria. Questo significa che non viene traslata di alcun bit, ed è quindi 
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indipendente dagli estremi della linea. Per rendere indipendente la collocazione del 
byte della matrice grafica dalla posizione della linea orizzontale sullo schermo, GEOS 
provvede a mascherare alcuni bit del byte in maniera che la visualizzazione della 
matrice di continuità della linea inizi proprio dove inizia la linea e termini esattamente 
ove la linea termina. Dal momento che la matrice di continuità viene poi ripetuta 
orizzontalmente per ottenere la linea, nell’ultima ripetizione sarà troncata per 
visualizzare l’esatta lunghezza della linea. L’effetto prodotto dal costante allineamento 
del byte della matrice grafica con gli spazi carattere dello schermo, cioè la sua 
indipendenza dai limiti della linea, si osserva per esempio disegnando due linee 
orizzontali una di fianco all’altra con diversa lunghezza e stessa matrice grafica: hanno 
evidentemente lo stesso disegno di continuità e i due disegni sono allineati. I bit a 0 
e i bit a 1 delle due linee, essendo queste prodotte con la stessa matrice grafica, sono 
allineati verticalmente. 

Per esempio, supponiamo che GEOS disegni una linea dal punto A al punto B della 
linea di scansione: 
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con la seguente matrice di continuità: 



Matrice di continuità 


Il byte della matrice di continuità è sempre allineato in modo tale che un suo bit, 
per esempio il bit 0, appaia sempre nel bit 0 di ogni byte della RAM allocata per lo 
schermo grafico. Per iniziare e terminare la linea nei punti prefissati, vengono 
mascherati gli opportuni bit del byte della matrice grafica d’inizio e di fine della linea: 


I-1 ◄ Bit che vengono mascherati ► j-1 

I_I_I_I_I_I 


Confini degii spazi carattere 
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Le linee verticali sono disegnate in modo simile. In questo caso il byte della matrice 
di continuità è disposto verticalmente e scritto sullo schermo dall’alto in basso. Anche 
per le linee verticali vale lo stesso discorso di allineamento delle matrici con gU spazi 
carattere in maniera indipendente dagli estremi della linea. Il tempo impiegato per 
disegnare una linea verticale è maggiore di quello necessario per le linee orizzontali, 
in quanto GEOS deve fare un maggior numero di operazioni per disegnare il byte della 
matrice grafica su otto diverse linee di scansione. Questo significa che il bit 0 della 
matrice grafica si trova in corrispondenza di un certo bit del primo byte, che dipende 
dalla coordinata x della linea, e il bit 1 si trova sul byte appena sottostante, sempre 
aU'altezza dello stesso bit. È quindi evidente che i bit della matrice grafica devono 
essere ripartiti in 8 byte diversi, e da questo deriva la relativa lentezza del processo. 
Scrivere un bit aU’intemo di un byte significa effettuare l'operazione logica OR fra il 
bit e il byte. Il tempo impiegato per disegnare una linea verticale è circa otto volte 
maggiore del tempo necessario per una linea orizzontale. 


Le linee diagonali 

Il procedimento di visualizzazione delle linee diagonali è diverso da quello utilizzato 
per le linee orizzontali e verticali. Le linee diagonali non vengono visualizzate 
utilizzando una matrice di continuità. GEOS le disegna “a piena continuità”, cioè ogni 
bit della linea è impostato a 1. Non è possibile indicare una matrice di continuità in 
quanto le linee diagonali risentono della bassa risoluzione grafica del C-64 e 
disegnandole non continue su un intervallo di continuità minore di otto bit (la matrice 
grafica sarebbe di otto bit) diventerebbero molto confuse. Inoltre bisognerebbe 
risolvere il problema di come disporre il byte della matrice grafica, se verticalmente 
oppure orizzontalmente, a seconda della pendenza della linea. Per evitare di trovarci 
di fronte a questi e altri problemi, che sono risolubili solo fino a un certo punto, 
abbiamo optato per le linee diagonali piene. Presentiamo ora le routine per disegnare 
le linee, e le routine per la manipolazione dei punti sullo schermo. 





Funzione: Disegna un punto con il colore di fondo o del tratto, oppure to copia dal 

buffer di schermo. 


indirizzo: $0133 

Accede a: Se disegna, cioè non copia dal buffer di schermo, accede a 

dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 

bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: N impostato a 1 per copiare un punto dai buffer di schermo, 

impostato a 0 per disegnare un punto sullo schermo 
C se N è impostato a 0, C impostato a 1 disegna il punto con il colore 
del tratto, C impostato a 0 disegna il punto con il colore di fondo 
r3 coordinata X del pixel (0 - 319) 

ri IL coordinata y del pixel (0 -199) 

Restituisce: r3, rllL inalterati 

Distnigge: a, x, y, r5 - r6 

Sinossi: Disegna un punto con il colore del tratto o di fondo, oppure copia lo stato 

del corrispondente bit dal buffer di schermo allo schermo principale. Queste 
operazioni si selezionano agendo sui bit di segno (N) e di carry (C) della 
parola di stato PSW del sistema. Se N è impostato a 1, allora il bit viene 
copiato dal buffer di schermo, cioè ripristinato sullo schermo principale. Se 
invece è impostato a 0 ci sono due diverse possibilità a seconda dello stato 
del flag di carry. Se C è impostato a 1 il punto viene disegnato con il colore 
del tratto (normalmente nero: il bit è impostato a 1 nella RAM di schermo), 
mentre se è impostato a 0 il punto viene disegnato con il colore del fondo 
(normalmente bianco: il bit è impostato a 0 nella RAM di schermo). 






Funzione: Restituisce il carry con il valore del pixel indicato. 

Indirizzo: $C13F 

Accede a: dispBufferOn 

bit 7 se è impostato a 1, il test viene effettuato sul pixel dello 
schermo principale 

bit 6 se è impostato a 1, il test viene effettuato sul pixel del buffer 
di schermo 

Se entrambi i bit 6 e 7 sono impostati a 1, viene restituito il risultato 
dall’operazione logica OR eseguita fra il pixel dello schermo 
principale e il pixel del buffer di schermo 

Parametri: r3 coordinata x del pixel (0 - 319) 

ri IL coordinata y del pixel (0 -199) 

Restituisce: C 1 se il bit è impostato a 1, altrimenti 0 

r3, rllL inalterati 

Distrugge: a, x, y, r5 - r6 

Sinossi: TestPoint restituisce il flag carry con il valore del pixel le cui coordinate sono 

passate in r3 e ri 1L. Il controllo può essere effettuato sul pixel dello schermo 
principale, su quello del buffer di schermo, o su entrambi, nel qual caso viene 
restituito il risultato dell'operazione logica OR eseguita fra i due pixel. Di solito 
l’istruzione jsr TestPoint viene immediatamente seguita dall’istruzione bcc o 
bcs in maniera che lo stato del pixel venga subito identificato. 






Funzione: Disegna una linea orizzontale ripetendo la matrice grafica, o di continuità, 

impostata. 


Indirizzo: $C118 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: a matrice monodimensionale di continuità per disegnare la linea (non 

è da confondere con le matrici grafiche bidimensionali di sistema 
offerte da GEOS) 

r3 coordinata x del limite sinistro della linea (0 - 319) 

r4 coordinata x del limite destro della linea (0 - 319) 

ri 1L coordinata y della linea (0-199) 

Restituisce: r3, r4, ri IL inalterati 

Distrugge: a, x, y, r5 - r8, rllH 

Sinossi: HorizontalUne disegna una linea orizzontale dalla coordinata x in r3 alla 

coordinata x in r4. La posizione verticale della linea è indicata dalla coordinata 
y contenuta in ri IL. La routine visualizza o meno i pixel di una linea 
orizzontale attenendosi alla maschera definita dalla matrice grafica. In questo 
modo a ogni bit impostato a 1 dalla matrice corrisponde sullo schermo un 
bit a 1 e viceversa. Il byte della matrice grafica monodimensionale viene 
ripetutamente memorizzato nei byte della RAM riservata per lo schermo, in 
maniera da visualizzare la linea orizzontale. Se l’estremo sinistro della linea 
non corrisponde al limite del byte, il byte della matrice grafica, prima di venir 
scritto nella RAM dello schermo, viene opportunamente troncato. Vale lo 
stesso discorso per l'estremo destro della linea. Due linee disegnate una 
accanto all’altra impiegando la stessa matrice grafica, hanno i bit impostati 
a 1 e a 0 allineati verticalmente. 

Nel caso si desideri visualizzare una linea orizzontale impiegando le matrici 
grafiche bidimensionali di sistema (8x8 pixel), conviene disegnare rettangoli 
alti un pixel, chiamando la routine Rectangle con la stessa coordinata y. 






Funzione: Disegna una linea verticale che dipende dalla matrice di continuità impostata. 

indirizzo: $C121 


Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: a byte della matrice grafica 

r4 coordinata X della linea (0 - 319) 
r3L limite superiore della linea (0 -199) 
r3H limite inferiore della linea (0-199) 

Restituisce: r3L, r3H, r4 inalterati 

Distrugge: a, x, y, rSL - rSL 

Sinossi: Disegna una linea verticale ripetendo la matrice di continuità passata 

attraverso il registro a. Un bit della matrice monodimensionale impostato a 
1 genera un bit a 1 sullo schermo, e viceversa, li byte della matrice di 
continuità viene disposto verticalmente. Se due linee verticali sono 
visualizzate con la stessa matrice grafica, una accanto all’altra, hanno i bit 
impostati a 1 e a 0 allineati orizzontalmente. Questo allineamento si ottiene 
memorizzando i byte delle matrici grafiche su 8 linee di scansione 
indipendentemente dai limiti verticali della linea. Come avviene per le linee 
orizzontali, i bit della matrice grafica che oltrepasserebbero i limiti verticali 
della linea vengono opportunamente troncati prima di essere visualizzati. 

Per disegnare una linea verticale utilizzando le matrici grafiche bidimensio¬ 
nali di sistema (8x8 pixel), conviene visualizzare un rettangolo largo un pixel 
chiamando la routine Rectangle con la stessa coordinata x. 
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Funzione: Inverte i bit di una linea orizzontale. 


Indirizzo: $C11B 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: r3 coordinata x dell’estremo sinistro della linea (0 - 319) 

r4 coordinata x dell’estremo destro della linea (0 - 319) 
ri IL coordinata y della linea (0 -199) 

Restituisce: r3, r4, ri IL inalterati 

Distrugge: a, x, y, r5 - r8 

Sinossi: La routine inverte tutti i bit che compongono una linea orizzontale. I pixel a 

1 diventano a 0 e viceversa. 
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ImprintLine 

RecoverLine 


Funzione: ImprintLine copia una linea orizzontale di bit dallo schermo principale nel 

buffer di schermo. Dal momento che questa routine non è direttamente 
accessibile alle applicazioni, si consiglia di chiamare ImprintRectangle 
indicando un rettangolo alto una linea di scansione. Rimandiamo quindi il 
lettore al paragrafo in cui tratteremo la routine ImprintRectangle. 

RecoverLine copia una linea orizzontale dal buffer di schermo; è la 
funzione complementare di ImprintLine. 

Indirizzo: RecoverLine $C11E 


Parametri: 


r3 coordinata x dell’estremo sinistro della linea (0 - 319) 
r4 coordinata x dell’estremo destro della linea (0 - 319) 
ri 1L coordinata y della linea (0 -199) 


Restituisce: r3, r4, ri IL inalterati 


Distrugge: a, x, y, r5 - r8 

Sinossi: ImprintLine - Copia dallo schermo principale nel buffer di schermo i bit che 

compongono una linea orizzontale. Per realizzare questa funzione, 
l’applicazione deve chiamare ImprintRectangle indicando un rettangolo alto 
una linea di scansione. 


RecoverLine - Copia i bit che compongono una linea orizzontale dal buffer 
di schermo allo schermo principale. Per questa funzione, i flag contenuti nella 
variabile dispBufferOn vengono ignorati: i pixel vengono sempre copiati sullo 
schermo principale indipendentemente dai valori dei flag. 






Funzione: Disegna, cancella, o copia dai buffer di schermo, una linea delimitata da due 

punti qualunque delio schermo. 

Indirizzo: $C130 


Accede a: DrawPoint tramite questa routine, eseguita ripetutamente, ia linea 

viene costruita punto per punto 

dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: N se è impostato a 1 copia i bit dal buffer di schermo, 

se è impostato a 0 disegna 

C se N è a 0, impostato a 1 disegna, impostato a 0 cancella 
r3 x1 : coordinata x del primo punto (0 - 319) 

ri IL y1 : coordinata y del primo punto (0-199) 

r4 x2; coordinata x del secondo punto (0-319) 

ri IH y2: coordinata y del secondo punto (0-199) 

Restituisce: Registro di stato inaHerato 

Distrugge: a, x, y, r3 - r13 

Sinossi: DrawLine attiva, disattiva o copia dal buffer di schermo i pixel compresi nella 

linea che unisce due punti arbitrari dello schermo. Un bit è “attivato” quando 
è impostato a 1, “disattivato” quando è impostato a 0. 

DrawLine utilizza l’algoritmo di Breesenham per determinare quali bit sono 
interessati al cambiamento di stato (si consulti il libro Fundamentais of 
Interactive Computer Graphics di J. D. Foley e A. Van Dam per una 
spiegazione di questo algoritmo). La linea viene disegnata nello stesso modo 
anche scambiando fra loro i due estremi. L’algoritmo di Breesenham è stato 
scelto in quanto non utilizza operazioni di moltiplicazione e divisione. 

DrawLine mette a disposizione diverse possibilità: copiare una linea, 
disegnarla (bit a 1) o cancellarla (bit a 0). I valori contenuti nei fiag di segno 
(N) e di carry (C) della parola di stato PSW specificano quale operazione 
verrà effettuata. Se C è impostato a 1 la linea viene disegnata, mentre se è 
impostato a 0 la linea viene cancellata. Se N è impostato a 1 il flag di carry 
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C viene ignorato e i bit che costituiscono la linea ven^}no copiati dai buffer 
di schermo. 

Per impostare questi flag nel modo corretto, si possono adottare alcuni 
“trucchi". 

Usare sec e de per impostare a 1 o a 0 il carry (C). 

Usare Ida #-1 per impestare a 1 il flag di segno (N). 

Usare Ida #0 per impostare a 0 il flag di segno (N). 

Usare pip per impostare entrambi i flag secondo il valore 
contenuto nel primo byte deilo stack. 
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Il disegno degli spazi pieni 

Spiegheremo ora come ci si può servire di una matrice grafica per riempire gli spazi, 
e vedremo che concettualmente il metodo è simile a quello adottato per introdurre il 
disegno delle linee. In questo caso la matrice grafica non è più 1x8 pixel (un byte), 
ma 8 X 8 pixel (8 byte). Anche in questo caso la matrice grafica è sempre allineata con 
gli spazi carattere in maniera indipendente dall’area visualizzata. Per meglio capire 
cosa intendiamo per allineamento indipendente, è utile immaginare lo schermo in alta 
risoluzione suddiviso in tenti piccoli quadrati di 8 x 8 pixel (gli spazi carattere). 
Imponendo che una matrice grafica sia sempre situate aU’interno di uno spazio 
carattere, e non a cavallo di due o più, otteniamo una gestione delle matrici grafiche 
molto simile alla gestione dello schermo a caratteri del C-64 quando non-è selezionato 
alcun modo grafico. La differenza risiede nella possibilità, tipica dell’ambiente GEOS, 
di mascherare parte della matrice grafica prima che sia visualizzate. In questo modo, 
anche se i limiti della matrice grafica non coincidono con quelli dello spazio da 
riempire, mascherando opportunamente le parti di matrice che li supererebbero si 
risolve il problema. Rendendo in questo modo indipendente la posizione delle matrici 
grafiche da quella dello spazio da riempire, si può essere certi che due regioni 
adiacenti “coperte” con la stessa matrice grafica saranno identiche, con continuità 
lungo il bordo a entrambe comune. La dimensione di 8 x 8 pixel scelte per le matrici 
grafiche si preste particolarmente bene a essere adoperate in modo bit-map con il C-64, 
in quanto lo schermo in alte risoluzione è suddiviso, dal punto di viste operativo, in 
gruppi di 8 byte. Nella semplice applicazione presentate nel precedente capitolo, 
abbiamo utilizzato senza illustrarle nei dettegli le due routine SetPattern e 
i_Rectengle. SetPattern serve per selezionare la matrice grafica (pattern) di sistema 
prima che sia utilizzate. Tramite queste routine, GEOS riserva 8 byte alla matrice 
grafica di sistema selezionate. SetPattern memorizza in questi 8 byte una delle diverse 
matrici grafiche disponibili in ambiente GEOS. A ogni matrice grafica è assegnato un 
numero. 

Le routine di disegno come i-Rectengle utilizzano la matrice grafica di sistema 
selezionate per riempire aree dello schermo. Nel caso della nostra semplice 
applicazione, abbiamo utilizzato SetPattern e i-Rectengle per cancellare lo schermo. 
GEOS manipola le aree piene come fa con le linee orizzontali e verticali. L’effetto che 
si ottiene riempiendo una zona dello schermo con una matrice grafica è simile a quello 
che si ottiene disponendo un foglio bianco su un panno disegnato e tagliandone via 
una parte in modo da rivelare il panno sottostante. Quando si disegna un’area piena 
sovrapponendola a un’altra, la matrice grafica della prima si allinea con quella della 
seconda. 

La figura della pagina successiva rappresenta un piccolo rettangolo i cui bordi non 
coincidono con i bordi dei quadrati occupati dalle matrici grafiche. L’area grigia 
rappresenta i bit delle matrici grafiche che devono essere mascherati in maniera che 
i bordi del rettangolo siano quelli richiesti, indipendentemente dalla sua posizione. 
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Matrice 

grafica 


L’area grigia include le parti delle matrici grafiche 
che vengono mascherate prima della visualizzazione 


Le routine grafiche che seguono servono per disegnare forme geometriche riempite 
con le matrici grafiche. 













Funzione: Seleziona la matrice grafica di sistema. 

Indirizzo: $C139 


Parametri: a il numero della matrice grafica che si desidera selezionare (0 - 31 ) 

Restituisce: curPattern aggiorna questa variabile con l'indirizzo della matrice grafica 

selezionata in a 

Distrugge: a 

Sinossi: Imposta la matrice grafica di sistema secondo una delle 32 disponibili in 

ambiente GEOS. L’indirizzo della matrice grafica selezionata è contenuto 
nella variabile curPattem. Tutte le routine che riempiono regioni dello 
schermo, come Rectangie, disegnano utilizzando la matrice grafica di 
sistema correntemente selezionata. 
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Rectangle, LRectangle 


Funzione: 

Disegna un rettangolo riempito 
selezionata. 

Indirizzo: 

Rectangle $C124 

LRectangle $C19F 

Accede a: 

dispBufferOn 

bit 7 se è impostato a ' 
bit 6 se è impostato a 

Parametri: 

Normali 


cx)n la matrice grafica correntemente 


scrive sullo schermo principale 
scrive sul buffer di schermo 


r2L coordinata y del lato superiore del rettangolo in linee di scansbne 
(0 -199) 

r2H coordinata y del lato inferiore del rettangolo in linee di scansione 
(0 -199) 

r3 coordinata x del lato sinistro del rettangolo in pixel (0 - 319) 

r4 coordinata x del lato destro del rettangolo in pixel (0 - 319) 


Inline 

I parametri devono apparire subito dopo l’istruzione jsr 
•byte coordinata y del lato superiore del rettangolo 
•byte coordinata y del lato inferiore del rettangolo 
.word coordinata x del lato sinistro del rettangolo 
.word coordinata x del lato destro del rettangolo 


RestìtoJìsce: r2, r3, r4 inalterati 


Distrugge: a, x, y, r2, r5 - r8, ri 1 

Sinossi: Disegna un rettangolo di coordinate date riempito con la matrice grafica di 

sistema selezionata. Tale matrice grafica può essere cambiata chiamando 
SetPattern. La matrice grafica di sistema corrente è una matrice 8x8 pixel 
che viene visualizzata sullo schermo con i bordi coincidenti con quelli degli 
spazi carattere ottenuti supponendo di dividere lo schermo in 1000 quadrati 
da 8 X 8 pixel (questa suddivisione individua esattamente gli spazi carattere 
del modo testo del C-64). Quando il perimetro del rettangolo non corrisponde 
a quello dello spazio caratteri, le matrici grafiche interessate, prima di essere 
visualizzate, vengono parzialmente mascherate, in modo da non eccedere 
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i limjti del rettangolo. Si rimanda il lettore all’inizio di questo capitolo per 
maggiori dettagli. 

Rectangle opera chiamando ripetutamente HorizontaLine in un loop, e 
assegnando, a ogni chiamata, il byte di continuità correntemente prelevato 
dalla matrice grafica di sistema selezionata, hi questo modo, le applicazione 
possono supportare matrici grafiche con altezze maggiori (8 x 16 o 8 x 32 
pixel), chiamando ripetutamente HorizontalLine in un loop. 

Per incorniciare un rettangolo si deve prima chiamare Rectangle e 
successivamente FrameRectangle, altrimenti Rectangle cancella la cornice. 
C’è anche la possibilità di chiamare prima FrameRectangle, ma le coordinate 
da passare devono essere (x1-1, y1-1) e (x2+1, y2+1), in modo che 
Rectangle non possa cancellare FrameRectangle. In questo modo, però, le 
dimensioni del rettangolo visualizzato sono ovviamente maggiori. 





FrameRectangle, uFrameRectangle 

Funzione: 

Visualizza le linee di una cornice utilizzando il byte della matrice di continuità 
impostata. 

Indirizzo: 

FrameRectangle $C127 

UFrameRectangle $C1A2 

Accede a: 

dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: 

Normali 

a byte della matrice di continuità nella forma che si utilizza per 

disegnare le linee orizzontali e verticali. 
r2L coordinata y del lato superiore del rettangolo in linee di scansione 

(0 -199) 

r2H coordinata y del lato inferiore dei rettangolo in linee di scansione 

(0 -199) 

r3 coordinata x del lato sinistro del rettangolo in pixel (0 - 319) 

r4 coordinata x del lato destro del rettangolo in pixel (0 - 319) 


Inline 

1 parametri devono apparire subito dopo l’istruzione jsr 

.byte lato superiore del rettangolo 

.byte lato inferiore del rettangolo 

.word lato sinistro del rettangolo 

.word lato destro del rettangolo 

•byte matrice di continuità 

Restituisce: 

r2 - r4 inalterati 

Distrugge: 

a, X, y, r5 - r9, ri 1 

Sinossi: 

Utilizza il byte della matrice grafica, passato attraverso a, per disegnare le 
linee larghe un pixel della cornice. Il byte della matrice grafica è disposto 
verticalmente per disegnare i lati sinistro e destro della cornice. Come per 
le altre routine di disegno, il byte della matrice di continuità viene allineato con 
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gii spazi carattere. Si rimanda all’inizio di questo capitolo per maggiori 
dettsyli. 

Per incorniciare un rettangolo pieno beogna chiamare Rectang^ prima di 
FrameRectangle, altrimenti Rectangle cancella la cornice. FrarroRectangle 
disegna un rettangolo vuoto (cioè una cornice le cui linee sono larghe un 
pixel e sono disegnate con il colore del tratto) sopra un rettangolo pieno. Se 
si chiama Rectengle (xxì gli stessi parametri con cui era stato chiamato 
FrameRectan^, Rectang^ cancefla la cornice perché GEOS considera 
tutte le dimensioni in modo inclusivo. C’è anche la possibilità di c^iiamere 
prima FrameRectangle, ma in questo cesoie coorr^ate da passare devono 
essere (x1-1, y1-1) e (x2+1, v^+1), con la conseguenza che le dimensioni 
del rettangolo aumentano. 




Funzione: Inveite i pixel contenuti in un rettangolo. 

Indirizzo: $C12A 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: r2L coordinata y del lato superiore del rettangolo in linee di scansione 

(0 -199) 

r2H coordinata y del lato inferiore del rettangolo in linee di scansione 
(0 -199) 

r3 coordinata x del lato sinistro del rettangolo in pixel (0 - 319) 

r4 coordinata x del lato destro del rettangolo in pixel (0 - 319) 

Restituisce: r2 - r4 inalterati 

Distrugge: a, x, y, r5 - r8, ri IL 

Sinossi: I pixel contenuti nei rettangolo di dimensioni date vengono invertiti. I valori 

logici 1 diventano 0 e viceversa. L'effetto è quello di cambiare il cobre del 
tratto in colore di fondo e il colore di fondo in cobre del tratto. Questa routine 
può essere utile per segnalare all’utente l’avvenuta selezione di un oggetto. 

InvertRectangle opera chiamando InvertUne aH’intertio di un loop. 






RecoverRectangle, LRecoverRectangle 


Funzione: Copia un rettangolo dai buffer di schermo. 

Indirizzo: RecoverFiectangle $C12D 

LRecoverRectangle $C1A5 

Accede a: dispBufferOn ignorato 

Parametri: Normali 

r2L coordinata y del lato superiore del rettangolo in linee di scansione 
(0 -199) 

r2H coordinata y del lato inferiore del rettangolo in linee di scansione 
(0 -199) 

r3 coordinata x del lato sinistro del rettangolo in pixel (0-319) 

r4 coordinata x del lato destro del rettangolo in pixel (0 - 319) 

Inline 

I parametri devono apparire subito dopo l’istruzione jsr 
.byte coordinata y del lato superiore del rettangolo 
.byte coordinata y del lato inferiore del rettangolo 
.word coordinata x del lato sinistro del rettangolo 
.word coordinata x del lato destro del rettangolo 

Restituisce: r2 - r4 inalterati 

Distrugge: a, x, y, r5 - r8, ri 1 

Sinossi: I pixel contenuti nel rettangolo delle dimensioni date vengono copiati dal 

buffer sullo schermo principale in un rettangolo delle stesse dimensioni e 
identica posizione. Il disegno dello stesso rettangolo presente sullo schermo 
principale viene perso. È bene ricordare che il disegno nel buffer di schermo 
dev’essere già presente prima della chiamata a questa routine, in modo che 
sia effettivamente presente qualcosa da copiare. 
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ImprìntRectangle, UmprintRectangle 


Funzione: Copia i bit contenuti in un rettangolo di dimensioni date dallo schermo 

principale nel buffer di schermo. È la funzione complementare di 
RecoverRectangle. 

Indirizzo: ImprintRectangle $C250 

UmprintRectangle $C253 


Accede a: dispBufferOn ignorato 


Parametri: Normali 

r2L coordinata y del lato superiore del rettangolo in linee di scansione 
(0 -199) 

r2H coordinata y del lato inferiore del rettangolo in linee di scansione 
(0 -199) 

r3 coordinata x del lato sinistro del rettangolo in pixel (0 - 319) 

r4 coordinata x del lato destro del rettangolo in pixel (0 - 319) 

Inline 

I parametri devono apparire subito dopo l’istruzione jsr 
•byte coordinata y del lato superiore del rettangolo 
.byte coordinata y del lato inferiore del rettangolo 
.word coordinata x del lato sinistro del rettangolo 
.word coordinata x del lato destro del rettangolo 


Restituisce: r2 - r4 inalterati 


Distrugge: a, x, y, r5 - r8, ri IL 

Sinossi: ImprintRectangle copia un rettangolo dallo schermo principale al buffer di 

schermo nella stessa posizione. Chiamando RecoverRectangle con gli 
stessi parametri si ottiene la copia nella direzione opposta, cioè dal buffer di 
schermo allo schermo principale. 
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La grafica in modo bit-map 

Può capitale di voler realizzare figure complicate, che noir possono essere ottenute 
semplicemente con un insieme di linee, cornici e rettangoli pieni. In questi casi è utile 
gestire la figura come una zona di schermo bit-map in alta risoluzione, e memorizzarla 
come un gruppo di dati grafici. L’unico problema per gestire così le figure è che in 
modo bit-map occupano molto spazio di memoria. Quindi è necessario creare alcuni 
algoritmi in grado di minimizzare il numero di byte che definiscono una figura in 
bit-map. 

In generale, i dati grafici che definiscono le figure si adattano perfettamente a essere 
compattati con metodi che minimizzano le ripetizioni (Run-Lenght Encoding Method). 
Con questi metodi, i dati in modo bit-map vengono considerati un’unica lunga stringa 
di byte. Prima di proseguire, è bene precisare che il lettore non deve confondere 
l’argomento che stiamo trattando con le specifiche imposte dal C-64 per visualizzare 
i dati in modo bit-map; la compattazione dei dati serve unicamente per conservare le 
schermate in uno spazio di memoria minore, ma dev’essere disabilitata quando si 
richiede la visualizzazione dei dati. Quindi dire che i metodi di compattazione 
considerano i dati grafici come una lunga stringa di byte, non significa dire che è 
cambiato il modo di visualizzazione delle schermate imposto dal C-64. Si tratta di due 
argomenti completamente diversi. La compattazione e la successiva espansione dei 
dati sono operazioni indipendenti dalla loro visualizzazione. A livello teorico si 
potrebbe pensare di compattare anche i dati che compongono un file di testo ASCII, 
ma in realtà non è conveniente perché il metodo di compattazione che si utilizza è 
efficace solo se nel gruppo di dati esistono molte ripetizioni sequenziali di singoli byte 
o di gruppi di byte. E questo si verifica più facilmente quando i dati definiscono le 
schermate in modo bit-map. 

Si verifica spesso, nei gruppi di dati grafici che definiscono una figura in modo 
bit-map, che il valore di un byte sia ripetuto lungo il gruppo di dati molte volte prima 
d’incontrare un nuovo valore. Questa sequenza di byte ugùàli può essere rappresentata 
in due soli byte, il primo dei quali contiene il numero di ripetizioni e il secondo il valore 
da ripetere. La compattazione dei dati è un argomento estremamente importante e 
molti testi di informatica lo trattano in modo esauriente. In questa sede ci limiteremo 
a parlare delle tecniche principali che si usano con GEOS. 

GEOS rende disponibili tre distinti metodi di compattazione per memorizzare i dati 
grafici in modo bit-map. I dati di definizione delle figure in ambiente GEOS che sono 
compattati secondo uno dei tre metodi, sono definiti “mappe grafiche" AU’interno 
della stessa mappa grafica possono essere impiegati anche tutti e tre i metodi di 
compattazione, scegliendo di volta in volta quello che può fornire l’ottimizzazione 
migliore. Questa opportunità permette al programma di compattazione di gestire i tre 
metodi in modo conforme alla struttura dei dati che compongono la mappa grafica. In 
realtà sono solo due i veri metodi di compattazione, mentre il terzo si limita a indicare 
il numero dei singoli byte che seguono (ogmmo dei quali deve apparire una sola volta). 
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Il primo byte di una mappa grafica è sempre un byte di conteggio, o contatore. 
All'interno di questo byte risiedono due importanti informazioni: il formato della 
compattazione e il numero di byte interessati. Il byte contatore e i dati a esso eissociati 
costituiscono un gruppo grafico compattato. Una serie di gruppi grafici compattati 
rappresenta una mappa grafica. 


I formati di cximpattazione 

Gli algoritmi di compattazione e di espansione considerano la mappa grafica 
suddivisa in linee di scansione orizzontali, e non come gruppi di ^ byte costituenti 
caratteri, come avviene durante la visualizzazione in modo bit-map con il C-64. Ci 
teniamo a ribadire che la compattazione e la visualizzazione sono due argomenti 
diversi e indipendenti l’uno dall’altro. 

Quando una mappa grafica non è compattata, qualsiasi byte in posizione N ha alla 
sua destra, sulla stessa linea di scansione, il byte in posizione N+1 (tranne quando il 
byte in posizione N è l’ultimo della linea di scansione e il byte in posizione N+1 è il 
primo della linea di scansione successiva). Questa organizzazione dei dati grafici è 
molto diversa dal modo in cui il C-64 gestisce i dati grafici in memoria. La ragione per 
cui in ambiente GEOS le schermate non compattate, prima di essere visualizzate, 
vengono memorizzate in questo modo, si spiega tenendo presente che la compattazio¬ 
ne dei byte è molto più efficace se viene effettuata secondo le linee orizzontali dello 
schermo, se cioè agisce sui byte di una stessa linea di scansione. Quemdo GEOS deve 
visualizzare una mappa grafica compattata, compie due operazioni. Per prima cosa 
analizza il formato della compattazione e ricava i dati grafici in forma non compatta. 
Quindi li memorizza, riordinandoli completamente secondo le esigenze del modo 
bit-map del C-64: il secondo byte ottenuto dall’espansione, per esempio, dev’essere 
memorizzato otto locazioni di memoria dopo la locazione in cui è stato memorizzato il 
primo, perché appaia sulla stessa linea di scansione. Con questo metodo la 
visualizzazione delle figure è più lenta perché, oltre a espandere, GEOS deve anche 
riordinare i dati, ma dal momento che l’accesso al disco è molto più lento di qualsiasi 
altra operazione, compattare i dati e diminuire così il numero dei blocchi presenti sul 
disco rappresenta comunque un buon rispmmio di tempo. Analizziamo ora i diversi 
formati di compattazione. 

Ogni gruppo grafico compattato inizia con un byte di conteggio (Count Byte). Il suo 
valore determina anche il formato della compattazione. Per brevità, chiamiamo il 
valore del byte di conteggio COUNT. Se COUNT è compreso fra 0 e 127, cioè il bit 7 
è sempre a 0, il gruppo grafico è stato compattato con il primo formato. Un numero 
compreso tra 128 e 220 indica il secondo formato, mentre un numero compreso tra 221 
e 255 indica il terzo. Nel primo formato, il secondo byte è ripetuto un numero di volte 
pari al valore specificato da COUNT. Se per esempio il byte di conteggio contiene il 
valore 100 e il secondo byte il valore 0, quest’ultimo viene ripetuto 100 volte nella 
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schermata grafica da visualizzare in bit-map. Se COUNT è compreso fra 128 e 220 
(secondo formato), i (COUNT -128) byte che lo seguono sono riportati nella schermata 
grafica sequenzialmente, e ognuno compare una sola volta. Per esempio, se COUNT 
è uguale a 128 + 35 = 163, i 35 byte che seguono COUNT devono essere trascritti 
sequenzialmente uno per volta nella schermata grafica. Se COUNT è compreso fra 221 
e 255 (terzo formato), i byte che seguono sono da considerare in formato BIGCOUNT, 
un metodo di compattazione che merita qualche parola in più. 

BIGCOUNT è stato creato per comandare la ripetizione di una matrice grafica 
composta da diversi byte per un certo numero di volte. Spieghiamo cpiesto formato 
direttamente con un esempio. Supponiamo di avere una matrice grafica composta da 
quattro byte (xxxy), e di volerla ripetere cinque volte: 

xxxy xxxy xxxy xxxy xxxy 

Ogni matrice grafica è composta dai quattro byte xxxy. Per compattare questo 
gruppo di dati con il formato BIGCOUNT, si devono prima di tutto descrivere i quattro 
byte che compongono la matrice grafica utilizzando uno degli altri formati che 
abbiamo già analizzato, xxxy può essere descritta con il secondo formato; 132,x,x,x,y. 
In questo caso la chiave di interpretazione è: ripeti i prossimi quattro byte una volta 
ciascuno, sequenzialmente. Oppure la matrice grafica può essere compattata con il 
primo formato: 3,x,l,y. La chiave di interpretazione con il primo formato è: ripeti x tre 
volte e y una volta. 

Ouando la matrice grafica è stata interamente descritta con il primo o il secondo 
formato, GEOS deve sapere quanti byte occupa la descrizione della matrice grafica e 
quante volte dev’essere interamente ripetuta. Il primo byte del gruppo grafico 
compattato con il formato BIGCOUNT è il byte di conteggio il cui valore COUNT 
identifica il terzo formato e il numero di byte che compongono la singola matrice 
grafica (COUNT - 220). Il secondo byte contiene il numero di volte che GEOS deve 
ripetere la matrice grafica per intero. In conclusione il gruppo grafico compattato 
dell’esempio che stiamo facendo deve apparire come la seguente linea di byte: 

224,5,3,x,l,y oppure 224,5,132,x,x,x,y 

Si può notare che descrivendo la matrice grafica con il primo formato si risparmia 
un byte. In ogni caso, la ripetizione della matrice per cinque volte occuperebbe 20 byte, 
mentre compattata con il sistema che abbiamo spiegato occupa 6 byte con un 
risparmio di 14 byte. È chiaro quindi che la compattazione, usata nel modo più 
efficiente, riduce notevolmente il numero di byte che definiscono un disegno in modo 
bit-map. Segue una tavola riassuntiva dei tre formati di compattazione. 
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Formati di compattazione 


Count 

Formato 

Descrizione 

0 - 127 

COUNT,DATO 

Ripete COUNT volte il dato DATO 

128 - 228 

COUNT,DflT01,DflT02 

Ripete i <C0UNT - 128) dati che seguono 
una volta per uno 

221 - 255 

COUNT,BIGCOUNT,MATRICE 

(COUNT - 220) = numero di byte che compongono 
la matrice grafica, o PATTERN, Questo numero 
non comprende BIGCOUNT, BIGCOUNT * numero che 
indica quante volte la matrice grafica 
dev'essere ripetuta. MATRICE = insieme di byte 
(nel primo o nel secondo formato) che definisce 
la matrice grafica da ripetere 


Riassumendo, la mappa grafica è un insieme di gruppi grafici compattati, che 
utilizzano almeno uno dei tre formati di compattazione descritti. Un gruppo grafico 
compattato inizia con un byte che ne specifica il formato seguito da una serie di byte 
il cui significato dipende dal tipo di formato indicato. Dopo l’espansione, i byte del 
disegno sono riordinati da linee di scansione a spazi carattere di 8 byte, in modo da 
renderne possibile la visualizzeizione in modo bit-map da parte del C-64. 








Funzione: Visualizza un rettangolo in modo bit-map prelevandone i dati da una mappa 

grafica compattata. 

Indirizzi: BitmapUp $C142 

LBitmapUp $C1AB 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit j6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: Normali 

rO puntatore ai dati della mappa grafica compattata 
r1L coordinata x in byte del lato sinistro del rettangolo (0 - 39) 
r1H coordinata y in linee di scansione del lato superiore del rettangolo 
(0 -199) 

r2L larghezza in byte del rettangolo (0 - 39) 
r2H altezza in pixel del rettangolo (0-199) 

inline 

i parametri devono apparire subito dopo l'istruzione jsr 

.word puntatore ai dati della mappa grafica compattata 

.byte coordinata x in byte del lato sinistro del rettangolo (0 - 39) 

.byte coordinata y in linee di scansione del lato superiore del rettangolo 
(0 -199) 

.byte larghezza in byte del rettangolo (0 - 39) 

.byte altezza in pixel del rettangolo (0-199) 

Restituisce: ri 1L inalterato 

Distrugge: a, x, y, rO - r9L 

Sinossi: BitmapUp visualizza una mappa grafica compattata sullo schermo. 

BitmapUp espande i dati e colloca il disegno sullo schermo in una posizione 
che dipende dalle coordinate x e y dei lati sinistro e superiore e dalle 
dimensioni del rettangolo da visualizzare. Abbiamo già illustrato ampiamente 
i tre formati di compattazione. BitmapUp non controlla se la posizione e le 
dimensioni del rettangolo sono corrette. Per ottenere la visualizzazione 
parziale di una mappa grafica si deve utilizzare la routine BitmapCiip, che ora 
descriveremo. 





GEOS E LA GRAFICA 


101 


Talvolta può rendersi utile visualizzare una mappa grafica solo in parte. La routine 
BitmapClip permette al programmatore di visualizzare aU’interno di una finestra una 
parte della mappa grafica. Solo la porzione della mappa grafica che appare all'interno 
della finestra sarà visibile. Il resto del disegno è mascherato e non viene visualizzato. 
C'è anche la possibilità di specificare quale parte della mappa grafica dev'essere 
visualizzata aH'interno della finestra aperta sullo schermo. In un certo senso si può 
pensare di far scorrere la mappa “sotto lo schermo", in modo che l'utente ne veda solo 
quella parte che viene “rivelata” dalla finestra aperta. 

A questo scopo, il programmatore deve innanzitutto specificare le coordinate della 
finestra e le deve passare attraverso i registri ri e r2, come vedremo fra poco. Quindi, 
nei registri ri IL e ri IH, deve decidere quanti byte GEOS deve saltare prima di iniziare 
a visualizzare i dati della mappa grafica. Memorizzando il valore 0 in ri IL, si fa 
corrispondere il lato sinistro della mappa grafica con il lato sinistro della finestra. Un 
valore pari a 10 in ri IL significa invece che prima di iniziare a visualizzare le linee di 
scansione della mappa grafica, i primi 10 byte di ogni linea di scansione devono essere 
mascherati in modo che il lato sinistro della finestra corrisponda all'undicesimo byte 
di ogni linea di scansione. 

Se la mappa grafica, a partire dalla coordinata orizzontale specificata da ri IL, è più 
larga della finestra in cui deve apparire, una parte delia fine di ogni linea di scansione 
della schermata dev'essere mascherata. Il numero di byte in eccesso dev'essere 
specificato in ri IH e rappresenta la seconda coordinata orizzontale della parte di 
mappa grafica da visualizzare. Quando questi parametri sono stati specificati, la 
mappa grafica si trova a essere divisa orizzontalmente in tre parti; la prima parte è il 
numero di byte da saltare, prima di iniziare a visualizzare (memorizzato in rllL) la 
seconda parte conisponde alla larghezza in byte della finestra e la terza parte è 
costituita dai rimanenti byte che non devono essere visualizzati (il cui numero è 
memorizzato in ri IH). 

La collocazione verticale della mappa grafica parziale si ottiene in modo analogo. Il 
numero di righe di scansione che devono essere saltate prima dell'inizio è contenuto 
nella word rl2: variando il valore contenuto in rl2 si ottiene lo scroU verticale della 
mappa grafica aH'intemo della finestra. Ecco le specifiche che caratterizzano la routine 
BitmapClip. 
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BitmapClip 


Funzione: Visualizza airinterno di una finestra aperta sullo schermo un’area parziale di 

una mappa grafica. 


Indirizzo: $C2AA 


Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 


Parametri: 


rO puntatore all’inizio della mappa grafica in memoria 

r1L coordinata x del lato sinistro in byte della finestra dove viene 

visualizzata la mappa grafica (0 - 39) 
r1H coordinata y del lato superiore in pixel della finestra (0-199) 

r2L larghezza in byte della finestra (0 - 39) 

r2H altezza in pixel della finestra (0-199) 
ri IL numero di byte dall’inizio di ogni linea di scansione della mappa 
grafica da saltare prima di iniziare la visualizzazione aH’intemo della 
finestra 

ri 1H numero di byte rimanenti, a partire dalla fine della linea di scansione 
della mappa grafica, che non vengono visualizzati dopo che è stata 
disegnata la parte che riempie la finestra 
ri 2 questa word specifica il numero di linee di scansione, a partire dalla 
prima in alto della mappa grafica, che devono essere saltate prima 
di iniziare la visualizzazione del disegno all’intemo della finestra 


Restituisce: Niente 


Distrugge: a, x, y, rO - r12 

Sinossi: La routine BitmapClip si utilizza per visualizzare una parte di mappa grafica 

airinterno di una finestra definita dal programmatore. La finestra può trovarsi 
in qualunque posizione sullo schermo e può essere di dimensioni arbitrarie: 
rappresenta, di solito, uno spazio di lavoro dell’applicazione. rIL e rIH, 
insieme a r2L e r2H, definiscono le dimensioni della finestra al cui interno 
deve comp)arire la parte di mappa che si desidera visualizzare. rIL e rIH 
contengono le coordinate della posizione dell’angolo sinistro superiore della 
finèstra, mentre r2L ed r2H ne definiscono le dimensioni in larghezza e in 
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altezza. rO deve contenere rindirizzo in memoria ove inizia la mappa grafica 
da visualizzare. 

Dai momento che la larghezza della mappa può essere maggiore della 
larghezza della finestra, il programmatore deve specificare quale parte della 
mappa grafica deve apparire aH’interno della finestra. Questa informazione 
viene passata attraverso r11 ed r12. Ogni volta che BitmapClip “legge" una 
linea di scansione della mappa grafica, controlla il valore contenuto in ri 1L 
(che rappresenta il numero di byte da saltare all'inizio di ogni linea di 
scansione prima di iniziare a visualizzarla all’Interno della finestra), ri IH 
contiene il numero di byte in eccesso sulla linea di scansione. Attenzione: 
la larghezza della mappa grafica dev’essere uguale alla somma dei valori 
contenuti in ri IL (parte sinistra non visualizzata), ri IH (parte destra non 
visualizzata) e r2L (larghezza della finestra), ri 2 contiene il numero di linee 
di scansione, a partire dalla prima in alto della mappa grafica, che devono 
essere saltate prima di iniziare a visualizzare il disegno all’intemo della 
finestra. 

Qualche volta può essere necessario dover visualizzare in parte una 
mappa grafica molto grande, senza che questa possa essere contenuta 
completamente in memoria. La routine BitO^erClip permette di specificare 
una routine di input che restituisce in a il successivo byte, dopo l’analisi 
dell’eventuale compattazione. BitOtherClip continua a chiamare la routine di 
input, di solito ReadByte, fino a quando non ha completamente ricevuto un 
gruppo grafico compattato. Quindi lo espande e lo visualizza all’intemo di 
una finestra aperta sullo schermo, le cui dimensioni sono già state impostate. 





Funzione: Permette al programmatore di costruirsi una routine di input da utilizzare con 

BitmapClip. 

Indirizzo: $C2C5 


Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: rO puntatore a un buffer in memoria da 134 byte 

rIL coordinata x in byte del lato sinistro della finestra all’intemo della 
quale deve apparire il disegno in bit-map (0 - 39) 
rIH coordinata y in pixel del lato superiore della finestra (0-199) 
r2L larghezza in byte della finestra da aprire sullo schermo (0 - 39) 
r2H altezza in pixel della finestra da aprire sullo schermo (0 -199) 
ri IL numero di byte da saltare dall’inizio della linea di scansione prima 
di iniziarne la visualizzazione all’intemo della finestra 
ri 1H numero di byte rimanenti, a partire dalia fine della linea di scansione 

della mappa grafica, che non sono visualizzati dopo che è stata 
disegnata la parte che riempie in larghezza la finestra 
ri 2 questa word indica il numero di linee di scansione, a partire dalla 
prima in alto della mappa grafica, che devono essere saltate prima 
di iniziare la visualizzazione dei disegno 
ri 3 indirizzo della routine di input che restituisce il successivo byte della 
mappa grafica senza effettuare l’espansione 
ri 4 indirizzo della routine che BitOtherClip esegue quando ha terminato 
di gestire l’ultimo gruppo grafico e si prepara ad accettare il 
successivo. In virtù di alcuni miglioramenti realizzati in BitmapClip, 
questa routine non deve far altro che aggiornare nuovamente rO con 
l’indirizzo del buffer da 134 byte 

Restituisce: Niente 

Distrugge: a, x, y, rO - r14 

Sinossi: Qualche volta il programmatore può incontrare la necessità di visualizzare 

parte di una schermata che non può essere interamente contenuta in 
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memoria. Le mappe grafiche infatti possono essere anche molto grandi. 
BitOtherCiip permette al programmatore di costruire una routine di input che 
restituisce in a il successivo byte compattato (in uno dei tre formati che 
abbiamo già introdotto). Questa routine non deve alterare i registri rO - r13, 
e deve restituire un byte alla volta proveniente da una mappa grafica 
memorizzata su disco. Per compiere questa operazbne deve salvare i 
registri, chiamare la routine ReadByte (ReadByte restituisce il byte della 
mappa grafica in a; per maggiori dettagli sulla routine ReadByte consultare 
il carolo dedicato alla gestione dei file), e infine deve ripristinare i registri. 

BitOtherCiip continua a chiamare la routine puntata da r13 fino a quando 
i byte prelevati non compongono un gruppo grafico compattato. I byte 
ricevuti vengono memorizzati nel buffer specificato da rÓ. BitOtherCiip 
espande il gruppo grafico contenuto net buffer e lo visualizza sullo schermo. 
Quando la visualizzazione del gruppo grafico è finita, viene eseguita la 
routine il cui indirizzo è contenuto in r14. Questa routine non è 
particolarmente utile e dovrebbe semplicemente riaggiomare rO con 
l’indirizzo del buffer da 134 byte in maniera tale che BitOtherCiip possa 
prelevare il gruppo grafico successivo e visualizzarlo. Il buffer destinato a 
questa routine è lungo 134 byte, cioè la massima ampiezza possibile per un 
gruppo grafico. 
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Le routine GraphicsString 

Durante la progettazione di GEOS ci siamo accorti che le sue routine grafiche si 
prestano molto bene alla realizzazione della veste grafica iniziale di un’applicazione. 
Lo schermo di un’applicazione si può ottenere chiamando una dopo l’altra le routine 
grafiche di GEOS. L’unico inconveniente è che per ottenere im risultato di qualità, il 
numero delle routine da eseguire è abbastanza elevato. Così abbiamo pensato di offrire 
un piamolo aiuto al programmatore, dotando GEOS della routine GraphicsString, che 
consente di creare una stringa di dati contenente tutte le operazioni grafiche da 
effettuare. A ogni routine è assegnato im numero che la identifica. La stringa grafica 
deve contenere i numeri delle routine da chiamare, seguiti dai rispettivi parametri. 
Tramite questo accorgimento si possono lasciare liberi tutti i byte normalmente 
utilizzati per aggiornare i registri con i parametri e per contenere le istruzioni jsr. 

GraphicsString ha alcune caratteristiche degne di nota. La più interessante è che 
mantiene in memoria l’ultima posizione della simbolica ‘penna’ usata per disegnare. 
Molti comandi grafici si riferiscono alla posizione della penna sullo schermo, quando 
iniziano a disegnare. Per esempio, il comando LINETO disegna una linea dalla corrente 
posizione della penna alle coordinate x e y che seguono immediatamente il comando. 
La posizione che individua la fine della linea, ovvero quella di coordinate x e y, diventa 
la nuova posizione della penna sullo schermo. 

L’unica limitazione imposta da GraphicsString consiste nell’impossibilità di 
disegnare linee discontinue. Tutte le linee disegnate attraverso GraphicsString, come 
ad esempio i bordi dei rettangoli, sono continue. 

I parametri di cui abbiamo parlato vengono riassunti nella scheda che segue. 





GraphicsString, i-GraphicsString 


Funzione: Esegue i comandi grafbi indicati neila strìnga grafica. 

Indirizzo: GraphicsString $0136 

LGraphicsStrìng $C1A8 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrìve sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

Parametri: Normali 

rO puntatore all’inizio della strìnga grafica in memoria 
Inline 

I dati della strìnga grafica devono apparire subito dopo l'istruzione jsr 

Restituisce: Niente 

Distrugge: a, x, y, rO - r13 

Sinossi: GraphicsString esegue i comandi contenuti all’Interno di una strìnga grafica. 

Sono previsti 11 comandi grafici numerati dai comando 0 al comando 10. 
Ogni comando grafico dev’essere seguito dai gruppi di coordinate che lo 
caratterizzano. Le coordinate orizzontali occupano sempre due byte (0 - 
319), mentre le coordinate verticali occupano un solo byte (0 - 199). I 
comandi sono illustrati nella tavola della pagina successiva. 
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Comandi riconosciuti da GraphicsStrmg 


Comando 

Codice 

Dati 

Descrizione 

NULL 

e 

- 

Fine della stringa grafica 

MOVEPENTO 

1 

.word X 
.byte y 

Posiziona la "penna" alle coordinate 
assolute x e y 

LINETO 

2 

.word X 
.byte y 

Disegna una linea dalla corrente posizione 
della penna al punto di coordinate x e y, 
il quale diventaj a disegno avvenuto, 
la nuova posizione della penna 

RECTflNGLETO 

I 

3 

.word X 
.byte y 

Disegna un rettangolo dalla posizione 
corrente della penna alle coordinate x e 
y del vertice opposto lungo la diagonale; 

X e y diventano le coordinate 
della nuova posizione della penna 

PENFILL 

4 

N/fi 

Questo comando non e' attualmente 
disponibile. Inserendolo nella tavola 
non viene eseguita alcuna operazione 

NEWPflTTERN 

5 

.byte patternNu 

fissume come matrice grafica di sistema 
quella il cui numero e' patternNu 

ESC-PUTSTRING 

6 

.word xpos 
.byte ypos 
.byte stringa 

Comando per fare in modo che GEOS consideri 
i rimanenti dati come parametri inline 
della routine i-PutString 

FRflME-RECTO 

7 

.word X 
.byte y 

Crea una cornice dalla posizione corrente 
della penna al punto individuato 
dalle coordinate x e y del vertice opposto 
lungo la diagonale; x e y diventano le coor¬ 
dinate della nuova posizione della penna 

PENXOELTfl 

8 

.word dx 

figgiunge il valore dx alla coordinata 
orizzontale della penna 

PENYDELTfi 

$ 

.byte dy 

Aggiunge il valore dy alla coordinata 
verticale della penna 

PENXYDELTfl 

10 

.word dx 
.byte dy 

figgiunge i valori dx e dy rispettivamente 
alla coordinata orizzontale e a quella 
verticale della penna 
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Esempio: Disegna un rettangolo con la matrice grafica numero 0 dal punto di 

coordinate x e y al punto di coordinate x ' e y1, situato lungo la diagonale. 


jsr 

iJìrephicsString 

.byte 

NEUPflTTERN, 0 

.byte 

MOVEPEHTO 

.word 

X 

.byte 

y 

.byte 

RECTflNGLETO 

.word 

xl 

.byte 

yi 

.byte 

NULI 




Funzkme: Restituisce l'indirizzo di una linea di scansione dello schermo prescelto. 

Indirizzo: $C13C 


Parametri: x contiene la coordinata y della linea di scansione 

Restituisce: x inalterato 

r5 e r6 indirizzi del primo byte della linea di scansione restituiti secondo 
il valore contenuto in dispBufferOn: 

bit 7 bit 6 restituisce 

1 1 r5 = schermo principale; r6 = buffer di schermo 

0 1 r5, r6 = buffer di schermo 

1 0 r5, r6 = schermo principale 

0 0 errore: r5,r6-indirizzo del centro dello schermo 

Distrugge: a 

Sinossi: GetScanUne restituisce l’indirizzo del primo byte della linea di scansione la 

cui coordinata y viene passata in x. La routine memorizza gli indirizzi del 
primo byte della linea nei registri r5 e r6, secondo il valore contenuto in 
dispBufferOn. In questo modo l’applicazione, avendo già predisposto 
dispBufferOn, può impiegare entrambi i registri senza preoccuparsi che 
puntino al buffer di schermo o allo schermo principale. Eventualmente 
memorizza il dato due volte nella stessa locazione. Per esempio, 
l’applicazione che ha già impostato dispBufferOn ed eseguito GetScanUne 
può agire come segue; 

Idy xpos ; indice del byte all'interno della linea 

Ida grByte ;valore grafico da iiie»o ri zzarvi 

sta (r5), y jeventualmente memorizza in entrambi gli schermi 

sta (r6), y 





5 1 TESTI 

IN AMBIENTE GEOS 


Una delle migliori qualità di GEOS è la capacità di gestire in modo autonomo i testi, 
offrendo numerose alternative per quanto riguarda fonti carattere, stili e corpi. Queste 
caratteristiche sono disponibili per qualsiasi tipo d’applicazione. Naturalmente 
esistono applicazioni che hanno bisogno di queste potenzialità solo in parte, e altre, 
come per esempio un programma di desktop publishing, che utilizzano in maniera 
completa tutto quello che GEOS ha da offrire. Per soddisfare entrambe le esigenze, 
abbiamo suddiviso le routine di manipolazione dei testi in due livelli. Al livello più 
semplice GEOS mette a disposizione alcuni comandi per gestire frasi in input e in 
output. A questo livello la maggior parte del lavoro, come la spaziatura proporzionale 
e il cambio dello stile, viene eseguito da GEOS per intere frasi, liberando così il 
programmatore dal compito di creare un’articolata e complessa struttura di gestione 
dei caratteri. Sia l’input di testi digitati dall’utente, con la relativa generazione di eco 
sullo schermo, sia l’output su schermo, sono procedure interamente gestite dal Kernel 
di GEOS. L’unica operazione che per adesso GEOS non è in grado di compiere 
all’interno di una frase è la selezione di un’altra fonte carattere, o un cambio di corpo, 
perché la gestione delle fonti carattere può richiedere grandi spazi di memoria ed è 
l’applicazione - non il sistema - che deve provvedere ad allqcarli opportunamente. 

GEOS comunque possiede alcune routine di facile uso, utili alla realizzeizione di 
strutture in grado di manipxìlare le fonti carattere. La selezione di una nuova fonte 
carattere aU’interno di una linea richiede che l’applicazione lasci libera una parte della 
memoria, carichi la fonte carattere e la selezioni come fonte di sistema. 

Prima di tutto tratteremo le routine di più alto livello. Illustreremo, con un semplice 
esempio, la gestione di un testo nel quale la maggior parte del lavoro sauà compiuto 
da GEOS. Nel prossimo capitolo approfondiremo, invece, le routine di livello inferiore 
per la gestione dei singoli caratteri e delle fonti carattere. Il programmatore le potrà 
utihzzare per creare strutture di gestione dei testi anche molto complesse e articolate. 
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ma in questi casi il lavoro che dovrà essere svolto dall’applicazione, come vedremo, 
sarà molto maggiore. 


Manipolazione semplificata delle stringhe 

La tecnica più semplice che GEOS è in grado di offrire per realizzare l'input e l'output 
di testi consiste nell’impiego delle routine PutString e GetString. PutString visualizza 
una stringa di testo indicata dall’appiicazione. GetString accetta i caratteri digitati 
dall'utente, ne visualizza l’eco sullo schermo, e li alloca in una stringa di testo a 
terminazione nulla, aU’interno di un buffer opportunamente aissegnato. In genere 
queste due routine hanno il compito di visualizzare un messaggio all’utente 
(PutString) e successivamente di attendete la risposta (GetString). Vediamo come si 
utilizza PutString. 

La maggior parte delle stringhe utilizzate da GEOS devono terminare con il carattere 
nullo, che in ASCII ha il codice 0. Questo significa che la fine di una stringa è 
identificata da un byte di valore 0. Ecco un esempio di una stringa a terminazione 
nulla; 

TextLabel! .byte “Questa e' una stringa a terminazione nulla.'',8 

Il nostro compilatore Assembly riconosce i caratteri racchiusi tra una coppia di 
doppie virgolette come codici ASCII. Quindi i caratteri ASCII per la stringa “Questa e’ 
una stringa a terminazione nulla.” sono memorizzati sequenzialmente. L’ultimo 
carattere è il carattere nullo (0), che non viene visualizzato ed è interpretato come 
terminatore della stringa. Una stringa di caratteri strutturata in questo modo si dice 
“a terminazione nulla”. PutString visualizza la stringa a partire da una particolare 
posizione sullo schermo che dev’essere specificata dall’apphcazione. La chiamata a 
PutString per visualizzare la stringa si realizza con le seguenti istruzioni: 

LoadM r0, TextLabel ,'r0 punta il primo byte della stringa in memoria 

LoadB ri, YPOSCOHSTFINT ;coordinata y della posizione in cui visualizzare 

;la stringa <0 - 199) 

Lo'adU rii, XPOSCONSTfINT jcoordinata x della posizione in cui visualizzare 

jla stringa (8 - 319) 

jsr PtfVstring 

nelle quali YPQSCQNSTANT e XPQSCQNSTANT sono le coordinate che individuano 
la posizione sullo schermo dell’angolo sinistro in basso del primo carattere della 
stringa. È disponibile anche la forma inline di passaggio dei parametri; L-PutString. 
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La chiamata inline è la seguente: 

Jsr i-PutStrin 9 ^chiamata alla routine 

•word XPOSCONSTflNT )coordinata x (8 - 319) 

.byte YPOSCONSTflNT {coordinata y (8 - 199) 

.byte “Questa e' una stringa a terminazione nulla"j8 ;la stringa da visualizzare 
... ;al ritorno dalia routine il program counter riprende da <iui 


n vettore di errore 

Cosa accade se si verifica un errore? Supponiamo che la stringa che si desidera 
visualizzare utilizzando PutString sia sufficientemente larga da oltrepassare il limite 
destro dello schermo. Quando PutString visualizza la stringa e questa raggiunge il 
limite destro dello schermo, GEOS controlla se è presente un indirizzo nel vettore 
stringFaultVec. Questo vettore è generalmente impostato a 0 da GEOS durante 
Tinizializzazione del sistema. Se il valore in esso contenuto è ancora 0 quando 
PutString indica che la stringa oltrepassa il margine destro dello schermo, allora non 
verrà visualizzato nessim altro carattere della stringa. Se invece l’applicazione ha 
memorizzato in stringFaultVec l’indirizzo di una routine, GEOS la esegue, passando 
in a il valore ASCII del carattere la cui visualizzazione oltrepasserebbe il margine 
destro, in rllL la coordinata x e in ri IH la coordinata y del carattere. 

I margini utilizzati da PutString devono essere memorizzati nelle variabili 
leftMargin e rightMargin. La routine attivata attraverso il vettore stringFaultVec, 
controlla le coordinate x e y per individuare quale margine è stato oltrepassato. Di 
solito ha il compito di visualizzare a capo i caratteri che superano il margine destro. 
Effettua questa operazione tramite la routine PutChar che analizzeremo nel prossimo 
capitolo. Sempre nel prossimo capitolo vedremo come operare una perfetta 
impaginazione del testo entro i margini definiti. 


Cambiamenti di stile all’interno delle stringhe 

PutString è in grado inoltre di gestire i caratteri che controllano i cambiamenti di 
stile all’interno delle stringhe. Questi caratteri sono speciali valori ASCII che 
normalmente non sono stampabili, come i caratteri di controllo ottenuti con il tasto 
control (CTRL). Il primo carattere ASCII visualizzabile è il 32, che indica lo spazio. 
GEOS utilizza i valori ASCII minori di 32, destinandoli a comandi che modificano lo 
stile della stampa, per esempio da nero (bold) a nero corsivo (bold italic). Noi 
chiamiamo questi caratteri di controllo “caratteri escape”, in quanto obbligano 
momentaneamente PutString a lasciare l’operazione in corso e a cambiare lo stile. In 
seguito, PutString continuerà a visualizzare in nero corsivo i successivi caratteri. 
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Quello che accade si può descrivere come segue: PutString sta visualizzando una 
stringa sullo schermo utilizzando lo stile nero, quando incontra tra i caratteri della 
stringa il carattere escape 25 (decimale), che aU’interno di una stringa da visualizzare 
indica lo stile corsivo. Allora interrompe per un attimo la visualizzazione dei caratteri 
ed effettua il cambiamento di stile. I successivi caratteri saranno visualizzati in nero 
corsivo. In altre parole, gli effetti dei due comandi escape si sommano; un comando 
di corsivo non cancella il precedente comando di nero. 

Quando PutString incontra un carattere escape, memorizza nella variabile GEOS 
currentMode il valore del nuovo stile. In currentMode ogni stile è associato a un bit. 
Quando si incontra un carattere escape, il corrispondente bit in currentMode viene 
aggiornato. Se, come nel nostro esempio, lo stile corrente è il nero e PutString incontra 
il carattere escape per lo stile corsivo, i caratteri successivi saranno visualizzati in nero 
corsivo. Infatti il bit corrispondente allo stile nero rimane a 1 mentre quello per lo stile 
corsivo passa da 0 a 1. L'unica eccezione a questa regola si verifica per il carattere 
escape che identifica lo stile “tondo”. In questo caso tutti i bit dei diversi stili contenuti 
in currentMode vengono azzerati, in modo che il sistema torni allo stile tondo (quello 
normale, senza alterazioni della fonte carattere). 

Quando PutString termina la visualizzazione della stringa, currentMode non viene 
alterato. La successiva chiamata a PutString, o a una qualunque delle altre routine di 
output su schermo, visualizzerà i caratteri ancora nello stile precedentemente 
impostato. È quindi una buona regola, se si desiderano stili particolmi, che le stringhe 
in output abbiano come primo byte il carattere escape per lo stile tondo, in maniera 
da disabilitare qualsiasi precedente selezione, e nei byte successivi i caratteri escape 
che impostano gli stili desiderati. 


n carattere escape di cambio della fonte carattere 

PutString può anche incontrare il carattere escape di cambio della fonte carattere 
aU’interno di una stringa di output. Per cambio della fonte carattere s’intende anche 
solo la selezione di un nuovo set di caratteri (corpo) aU’interno della stessa fonte. 
Questo carattere escape consiste nel valore 23 (decimale), seguito da una word che 
indica l’identificatore del set di caratteri (da qui in poi Font ID) e un byte per 
specificare lo stile. Il Font ID dev’essere sempre seguito da un carattere escape di 
controllo dello stile, dal momento che l’applicazione, nel momento in cui incontra un 
carattere escape, ha bisogno di sapere quali stili sono attivati. Come abbiamo già 
anticipato, PutString non è in grado di effettuare il cambio della fonte carattere perché 
dovrebbe possedere la capacità di allocare nuovo spazio di memoria, ma dal momento 
che i caratteri escape non sono stati creati per essere usati solo da questa routine, 
abbiamo ugualmente inserito un carattere escape per il cambio della fonte. PutString 
lo ignora, e ignora anche il byte seguente di impostazione degli stili. 
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I caratteri escape di cambio della posizione 

Con il termine “cursore” intendiamo sempre la posizione sullo schermo su cui GEOS 
sta scrivendo, sia quando il cursore è visibile (input dall'utente) sia quando non lo è 
(output all'utente). Esistono alcuni caratteri escape che modificano la posizione 
corrente del cursore sullo schermo. HOME porta il cursore all’angolo superiore sinistro 
dello schermo (le coordinate x e y vengono azzerate). UPLINE muove il cursore verso 
l’alto di un numero di pixel pari all’altezza della fonte carattere adottata. GOTOX e 
GOTOY e GOTOXY portano il cursore su una specifica posizione. La word che segue 
GOTOX diventa la nuova coordinata x del cursore (0 - 319). Il byte che segue GOTOY 
diventa la sua nuova coordinata y (0 -199). GOTOXY porta il cursore sulla posizione 
di coordinate x e y. La word che segue indica la coordinata x, e il successivo byte la 
coordinata y. 

La tavola seguente illustra i caratteri escape disponibili e la loro sintassi. 


I caratteri escape nei testi 


Carattere ASCII Funzione 


NULI 

BFICKSPflCE 


FORMflRDSPflCE 


LF (line feed) 


HOME 


0 Carattere che conclude la stringa 

8 Cancella il carattere precedente la cui larghezza e' 
raenio ri zzata in lastMidth, Se l'applicazione non si 
preoccupa di riaggiornare lastWidth, BflCKSPfiCE non può' 
essere utilizzato una seconda volta dopo aver cancellato 
l'ultiiiio carattere. Quindi per cancellare non solo 
l'ultiirio carattere, ma anche i precedenti, l'applicazione 
deve aggiornare la variabile lastWidth ogni volta 

che viene usato BfiCKSPflCE. Attenzione che lastWidth 
non e' una variabile normalmente disponibile 
alle applicazioni. Il suo indirizzo esadecimale 
in GEOS VI.2 e VI.3 e' $8807 

9 Muove il cursore verso destra, di un numero di pixel pari 
alla larghezza della fonte carattere correntemente 
selezionata 

10 Muove il cursore verso il basso di una riga (il numero 

di pixel per calcolare la posizione della riga sotto guella 

corrente si ottiene dalla variabile curHeight, 

che contiene il corpo della fonte carattere selezionata) 

11 Muove il cursore all'angolo sinistro in alto dello schermo 


SEGUE 
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SEGUE 



URLINE 

12 

Nuove il cursore verso l'alto di una riga (il nunero di pixel 
per calcolare la posizione della riga sopra quella corrente 
si ottiene dalla variabile curHeight, che contiene il corpo 
della fonte carattere selezionata) 

CR (carriage 

return) 13 

Nuove il cursore all'inizio della riga successiva: 
la coordinata x viene aggiornata con il valore contenuto 
nella variabile leftNargin, e viene inpartito autonaticanente 
il conando.LF per passare alla riga successiva 

ULINEON 

14 

Attiva la sottolineatura dei caratteri 

ULINEOFF 

15 

Disattiva la sottolineatura dei caratteri 

ESC-GRflPHICS 

16 

I byte che seguono costituiscono la stringa grafica che viene 
passata a GraphicsString 

ESC-RULER 

17 

Indica la presenza di una riga di definizione (ruler), 

PutSting ignora questo carattere escape 

REVON 

18 

Attiva la visualizzazione dei caratteri in negativo 

REVOFF 

19 

Disattiva la visualizzazione dei caratteri in negativo 

GOTOX 

20 

Utilizza la word che segue il comando come nuova coordinata 

X del cursore 

GOTOY 

21 

Utilizza il byte che segue il comando come nuova coordinata 
y del cursore 

GOTOXY 

22 

Utilizza la uord che segue il comando come nuova coordinata 

X del cursore e il successivo byte come nuova coordinata y 
del cursore 

NEUCRRDSET 

23 

Indica il cambio della fonte carattere. La uord che lo segue 
identifica il Font 10, e il byte successivo lo stile con il 
quale continuare a scrivere. Dal momento che PutString non e' 
in grado di gestire il cambio della fonte carattere, 
la routine ignora il comando e i tre byte successivi 

BOLOON 

24 

Attiva la visualizzazione dei caratteri in nero 

ITflLICON 

25 

Attiva la visualizzazione dei caratteri in corsivo 

OUTLINEON 

26 

Attiva la visualizzazione dei caratteri in outline 

PLflINTEXT 

27 

Attiva la visualizzazione dei caratteri in tondo, disattivando 
tutti i precedenti stili di scrittura. I caratteri ora sono 
quelli della fonte carattere selezionata, senza alcuna modifica 





Funzione: Visualizza una stringa di caratteri sullo schermo. 

Indirizzo: Putstring $C148 

LPutString $C1AE 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

leftMargin 

rightMargin 

windowTop 

windowBottom se la stringa durante la visualizzazbne oltrepassa uno 
qualunque di questi limiti, sia orizzontale sia verticale, 
GEOS chiama la routine puntata dal vettore 
stringFaultVec. Se questo vettore è azzerato, i caratteri 
che oltrepassano questi limiti non vengono visualizzati 

Parametri: Normali 

rO indirizzo della stringa a terminazione nulla 
r1H coordinata y della posizione in cui inizia la visualizzazione del 
testo (0-199) 

ri 1 coordinata x della posizione in cui inizia la visualizzazione del 
testo (0 - 319) 

Inline 

i parametri appaiono subito dopo l’istruzione jsr 
.word coordinata x della posizione in cui inizia la visualizzazione del 
testo (0 - 319) 

.byte coordinata y delia posizione in cui inizia la visualizzazione dei 
testo (0-199) 

.byte “Testo della stringa”,0 

Restituisce: ri 1 coordinata x del successivo carattere da visualizzare 

rIH coordinata y del successivo carattere da visualizzare 

Distrugge: a, x, y, rOL, r2 - rIO, ri 2, ri 3 
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Sinossi: 


PutStrìng visualizza nella posizione data da x e y, la stringa di caratteri 
puntata da rO, che dev’essere una stringa a terminazione nulla, cioè 
conclusa dal carattere NULL. PutStrìng visualizza il testo utilizzando la fonte 
carattere correntemente selezionata. Per cambiare la fonte carattere, prima 
di chiamare PutStrìng si devono utilizzare le routine LoadCharSet o 
UseSystemFont. PutStrìng accetta tutti i caratteri accettati da PutChar, e 
inoltre anche diverse sequenze di byte escape. Ogni sequenza di escape 
è composta da un carattere ASCII non stampabile seguito da uno o più b^e 
(a seconda del numero di parametri richiesti dal comando). La gestione dei 
testi è illustrata anche in appendice. 

PutStrìng non è in grado di interpretare il comando NEWCARDSET e i suoi 
parametri quando lo incontra lungo una strìnga di caratteri da visualizzare, 
infatti PutStrìng è incapace di gestire la memoria disponibile per creare lo 
spazio in cui caricare la nuova fonte carattere. 

Attenzione: PutStrìng non effettua alcun controllo sulla correttezza dei 
caratteri escape presenti all’intemo della strìnga. I caratteri ASCII dall’S al 27 
vengono considerati caratteri escape, mentre i valori esterni a questo range 
e minori del valore 32 producono sicuramente il blocco del sistema. 
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PutDecimal 


Funzione: Visualizza sullo schermo un numero binario da 16 bit in notazione 

decimale. 


Indirizzo: $C184 


Accede a: 


Parametri: 


Restituisce: 

Distrugge: 

Sinossi: 


dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 

leftMargin 

rightMargin 

windowTop 

windowBottom se il numero da visualizzare oltrepassa con una delle cifre 
uno qualunque di questi limiti, sia orizzontale che verticale, 
viene chiamata la routine puntata dal vettore 
stringFaultVec. Se il puntatore è azzerato i caratteri che 
oltrepassano questi margini non vengono visualizzati 

a Formato 

bit 7 impostato a 1 giustifica il numero a sinistra 
impostato a 0 giustifica il numero a destra 
bit 6 impostato a 1 sopprime gli zeri rimanenti 
impostato a 0 visualizza gli zeri rimanenti 
bit 0 - 5 contengono la larghezza del campo in cui deve 
apparire il numero quando si giustifica a destra 
rO il numero da visualizzare, composto da 16 bit 

ri 1 coordinata x del punto in cui visualizzare il numero (0-319) 

ri H coordinata y del punto in cui visualizzare il numero (0 -199) 

ri 1 coordinata x del successivo carattere da visualizzare 

rIH coordinata y del successivo carattere da visualizzare 

a, X, y, rO, r2 - rIO, r12, r13 

PutDecimal converte un numero binario in decimale e lo visualizza in caratteri 
ASCII utilizzando PutChar. PutChar, come sarà descritto più avanti, 
visualizza un carattere alla volta. Se viene selezionata la giustificazione a 
destra del numero, allora, attraverso i bit da 0 a 5 dell’accumulatore 
dev’essere passata la larghezza del campo. La posizione del pixel più a 
destra (il punto dal quale i caratteri iniziano a essere visualizzati verso 
sinistra) può essere calcolata sommando la larghezza del campo alla 
coordinata x passata attraverso ri 1. 
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L'input di stringhe 

L’input di stringhe di caratteri dall’utente, al livello più semplice, è svolto dalla 
routine GetString. È interessante analizzare il flusso delle operazioni principali che 
questa svolge, anche per puntualizzare ancora una volta che cosa significa parlare di 
un sistema operativo a gestione di eventi. GetString, quando viene mandata in 
esecuzione, aggiorna i vettori keyVector e stringFaultVec rispettivamente con gli 
indirizzi della routine di elaborazione dei caratteri e della routine di gestione degli 
errori di visualizzazione. Il precedente indirizzo contenuto in keyVector viene 
provvisoriamente salvato. Oltre a queste due operazioni fondamentali, GetString 
visualizza, tramite una chiamata alia routine PutString, la stringa eventualmente 
contenuta nel buffer previsto dall'applicazione. Questa caratteristica permette 
all’applicazione di generare l’input guidato di una stringa, facendo apparire il 
contenuto del buffer nel campo di input. In questo modo l’utente ha di fronte una 
possibile risposta già pronta. Questa operazione viene effettuata, per esempio, quando 
l’utente chiede a deskTop di cambiare il nome del disco. Si apre allora una finestra, 
aU’interno della quale appare un messaggio per l’utente, il nome corrente del disco e 
il cursore lampeggiante alla fine del nome. 

Quando Getótring ha compiuto le operazioni fondamentali, abilita il cursore visibile 
e restituisce il controllo a MainLoop (attraverso l’applicazione). A questo punto, 
ogniquedvolta MainLoop registra l’eurivo di caratteri dalla tastiera, esegue attraverso 
il vettore keyVector la routine impostata da GetString. Questa routine elabora il 
carattere passato dall’ultima esecuzione di InterruptMain. Una volta che il carattere 
è stato analizzato e memorizzato nel buffer, la routine restituisce il controllo a 
MainLoop, in modo che GEOS possa dedicare il suo tempo all’elaborazione di altri 
eventi (menu, pressioni del pulsante del mouse, icone...). Quando la routine puntata 
da keyVector si accorge che è stato premuto il tasto RE’TURN, inserisce nel buffer il 
carattere conclusivo nullo (0), disabilita il cursore visibile, ripristina keyVector, azzera 
StringFaultVec, e cede il controllo alla routine dell’applicazione il cui indirizzo era stato 
memorizzato nel vettore keyVector. È a questo punto che l’applicazione riceve la 
stringa in input dall’utente e può elaborarla. Quello che abbiamo appena descritto è 
il flusso primario delle operazioni svolte da GetString. 

È importante tenere ben presente che GetString non trattiene per sé il controllo della 
CPU, ma si limita ad aggiornare i vettori keyVector e stringFaultVec, in modo che 
venga eseguita la routine di elaborazione dei caratteri (quando MainLoop riprende il 
controllo) solo se l’utente preme un particolare tasto. Così, se l’utente sta scrivendo il 
nome di un file e decide di rinunciare all’operazione prima di premere il RETURN, ha 
la facoltà di spostare il mouse sull’icona CANCEL e interrompere l’input del nome. 
Questa sinergia fra eventi diversi (input di una stringa e selezione di un’icona, per 
esempio) è possibile soltanto perché MainLoop continua ad avere il controllo della 
CPU. Vediamo come vengono combinate di solito le routine PutString e GetString. 
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Normalmente accade che PutString viene utilizzata per visualizzare un messaggio 
all'utente, e GetString riceve la risposta sotto fotma di una stringa di caratteri, 
salvandola in un buffer temporaneo. PutString restituisce la posizione (x e y) del 
successivo ceirattere visualizzabile. Questa è la posizione alla quale verrebbe 
visualizzato il cmattere successivo. Aggiungendo uno spazio di due pixel orizzontali 
(almeno) alla coordinata x restituita da PutString, si ottiene una buona posizione sullo 
schermo per visualizzare l’eco dei caratteri inviati in risposta dall’utente. 

GetString, oltre alle coordinate x e y del punto in cui visualizzare l’eco dei caratteri 
immessi dall’utente, richiede altre informazioni. Per prima cosa deve sapere dove si 
trova il buffer temporaneo allocato dall’applicazione per memorizzare la stringa in 
input, e la sua lunghezza. Mentre l’utente inserisce i caratteri, GetString li memorizza 
nel buffer, e quando l’utente preme il tasto RETURN, termina\la stringa ricevuta nel 
buffer con il carattere NULL (0). GetString richiede che sia specificato il massimo 
numero di caratteri che può ricevere dall’utente. Questo numero non è altro che la 
dimensione del buffer. Se l’utente digita tanti caratteri da riempire il buffer, GetString 
accetta solo cenatteri come il Backspace e il Return, altrimenti non compie eilcuna 
operazione e lascia inalterato il buffer. 

Un altro errore che si verifica facilmente riguarda l’eco dei caratteri sullo schermo. 
Se l’utente inserisce tanti caratteri che l’eco prodotto oltrepassa il margine destro 
indicato da rightMargin, PutChar (utilizzata per la generazione dell'eco) esegue, 
treunite il vettore stringFaultVec, la routine di elaborazione della condizione d’errore. 
Questa routine può essere quella indicata dall’applicazione o può essere quella di 
default prevista da GEOS. L’applicazione ha quindi la facoltà di fare eseguire a GEOS 
una particolare routine quando l’utente batte un numero di caratteri tale da 
oltrepassare il margine destro indicato da rightMargin. Se la routine di elaborazione 
dell’errore di visualizzazione è quella messa a disposizione da GEOS, le operazioni 
compiute per risolvere il problema sono molto semplici. La routine non fa altro che 
cambiare il parametro che indica il numero massimo di caratteri che il buffer deve 
ricevere. Il nuovo valore corrisponde al numero di caratteri che GEOS è riuscito a 
visualizzare prima che si verificasse l’errore. In questo modo viene diminuita la 
lunghezza del buffer, e dal momento che GetString, quando il buffer è pieno, non 
compie alcuna operazione, non si presenta più alcun errore di visualizzazione. 





Funzione: Accetta una strìnga di caratteri in input dall’utente. 

Indirizzo: $C1BA 

Chiama: PutString, per visualizzare la strìnga eventualmente presente nel buffer 

passato dairutente prima di abilitare l'input 

Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrìve sullo schermo principale 

bit 6 se è impostato a 1 scrive sul buffer di schermo 

bit 5 se è impostato a 1, provvisoriamente GetString scrive sia 

sullo schermo principale sia sul buffer di schermo, ma 
quando la visualizzazione dell’eco del carattere si conclu¬ 
de, riprìstina in dispBufferOn il valore impostato dall’appli¬ 
cazione 

leftMargin 

rightMargin 

windowTop 

windowBottom se la stringa da visualizzare in eco sullo schermo oltrepassa 
uno di questi limiti, sia orizzontale sia verticale, GEOS 
chiama la routine puntata dal vettore stringFaultVec. Nel 
caso che il valore del puntatore sia 0, i caratteri successivi 
che oltrepassano uno dei margini non vengono visualizzati. 
Un’eccezione riguarda i margini verticali windowTop e 
windowBottom. Se una parte del carattere in eco oltrepassa 
uno dei due margini verticali, rimane visibile solo la parte del 
carattere rimasta entro i margini. Per esempio, provate a 
selezionare un qualunque file con l’opzione Info da 
deskTop, e a scrivere un testo molto lungo. Vi accorgerete 
che i caratteri dell’ultima riga in basso, saranno solo 
parzialmente visibili, e non si sovrappongono ai lati della 
cornice che racchiude lo spazio per i commenti 

Parametri: keyVector indirizzo della routine da chiamare quando l’utente ha 

completato l’input premendo RETURN 
rO indirizzo del buffer nel quale GetString memorizza la stringa 

ricevuta dall’utente 
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rIL byte di flag. Se il bit 7 è impostato a 1. GEOS accede alla word r4 
per puntare la routine che gestisce gli errori di visualizzazione 
r1H coordinata y in pixel del punto in cui la routine inizia a visualizzare 
l’eco dei caratteri (0-199) 

r2H massimo numero di caratteri che la routine può ricevere dall’utente 
ri 1 coordinata x in pixel del punto in cui la routine inizia a visualizzare 
l’eco dei caratteri sullo schermo (0 - 319) 
r4 (opzionale) indirizzo della routine che reagisce agli errori di 
visualizzazione 


Restituisce: Niente 
Distrugge: a, x, y, rO - r13 

Sinossi: GetString è facile da utilizzare e particolarmente adatta per le applicazioni 

che richiedono un input di caratteri da parte dell’utente. L’applicazione può 
passare a GetString una stringa a terminazione nulla nel buffer puntato da 
rO. GetString, prima di procedere all’input dei dati, visualizza il contenuto del 
buffer e sposta il cursore dopo l’ultimo carattere del buffer. In questo modo 
l’applicazione può offrire aH’utente una stringa di input guida, pioè di 
riferimento. Se l’applicazione non desidera passare a GetString alcuna 
stringa guida, deve ricordare di memorizzare uno 0 come primo carattere del 
buffer. 

GetString preleva i caratteri immessi dall’utente e li memorizza nel buffer 
puntato da rò. Quando l’utente preme RETURN, la stringa si conclude con 
il carattere NULL e viene eseguita la routine il cui indirizzo è contenuto in 
keyVector. Questa routine gestisce la stringa in input che GetString ha 
ricevuto e memorizzato nel buffer. 

I caratteri inseriti dall’utente vengono visualizzati in eco sullo schermo. 
GetString preleva i parametri x e y contenuti in ri 1 e rIH, quindi visualizza 
l’eco dei caratteri partendo dalla posizione così individuata. GetString 
richiede anche che sia specificato in r2L il massimo numero di caratteri che 
deve accettare dall’utente. Se l’utente immette un numero eccessivo di 
caratteri, la routine non li memorizza nel buffer e non compie nessun’altra 
operazione. 

Nel caso che l’eco dei caratteri oltrepassi il margine destro indicato da 
rightMargin, la routine PutChar, impiegata per la generazione dell’eco, non 
visualizza il carattere che oltrepassa il margine, ed esegue la routine indicata 
dal vettore stringFaultVec, senza più intervento da parte di GetString. È la 
routine che deve porre rimedio all’errore di visualizzazione. Il vettore 
StringFaultVec deve già essere stato preparato da GetString. Se l’applicazio¬ 
ne ha impostato a 1 il bit 7 del parametro rIL, GetString memorizza nel 
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vettore strìngFauttVec l'indirizzo deila routine puntata dal parametro r4 che 
l’applicazione ha opportunamente aggiornato. Se invece l’applicazione ha 
impostato a 0 il bit 7 dei parametro r1L, GetString memorizza in 
stringFaultVector l’indirizzo di una propria routine di gestione dell’errore. 
Quindi l’applicazione ha due possibilità, nei caso che si presenti un errore di 
visualizzazione; può prevedere una routine propria che se ne occupi, o può 
lasciare il compito a GEOS. Nel secondo caso, GEOS non fa altro che limitare 
il numero di caratteri che il buffer può axitenere a quelli che sono riusciti a 
essere visualizzati senza oltrepassare il margirie destro. Così il buffer non è 
più “troppo pieno", dal momento che è stato variato il numero massimo di 
caratteri che deve ricevere, e GetString si comporta come se avesse ricevuto 
il numero massimo di caratteri possibile. 




6 LE ROUTINE PER LA 
GESTIONE DEI OARATTERI 


Per molte applicazioni le routine PutString e GetString sono in grado di soddisfare 
pienamente tutte le esigenze legate alla gestione dei testi. Ma in realtà, queste due 
routine sono state ideate per l’elaborazione di un testo al livello più semplice, e non 
sono sufficienti per operare con i caratteri in modo più complesso. Dobbiamo quindi 
svincolarci dalla gestione delle stringhe, e inoltrarci nella manipolazione diretta dei 
caratteri, sia in input sia in output. A questo proposito GEOS prevede una serie 
completa di routine per aumentare la flessibilità del sistema. 

Queste sono le possibilità offerte; 

1) leggere e scrivere un carattere alle coordinate specificate 

2) stabilire la posizione del cursore visibile (una barra verticale) 

3) effettuare il cambio della fonte carattere 

4) richiedere quale larghezza e quale altezza ha un particolare carattere del corpo 
selezionato nella fonte corrente. 

Sfruttando solo queste quattro opzioni è possibile creare un sofisticato word 
processor. Per dare un esempio di come possono essere combinate insieme, proviamo 
a utiUzzarle per creare una semplice versione di GetString e della relativa routine di 
gestione dell'evento finale. Per differenziarla da GetString possiamo chiamarla 
OurGetString, mentre chiameremo OurInGetString la routine che gestirà effettivamen¬ 
te l’evento. In questo caso “gestione deirevento" significa leggere i caratteri 
provenienti dall’utente e memorizzarli nel buffer, visualizzare e aggiornare la posizione 
del cursore visibile, e generare l’eco dei caratteri sullo schermo. Quando la routine sarà 
completata nei suoi tratti fondamentali, si potrà ampliarla e renderla più sofisticata 
ottenendo anche che interpreti i caratteri di controllo. Un altro ritocco, inoltre, le 
potrebbe permettere di leggere da un buffer, anziché da tastiera, creando così un editor 
di testi. 



126 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


Iniziamo prendendo in considerazione keyVector e keyData. Il primo contiene 
l'indirizzo di una routine di gestione della tastiera che GEOS esegue quando analizza 
il relativo input. L’altro vettore viene invece ag0ornato da InterruptMain con il codice 
ASCII del tasto premuto dall’utente. Ogni volta che si preme un tasto, MainLoop 
manda in esecuzione la routine puntata da keyVector. All’inizio il vettore contiene il 
valore 0, in modo che qualunque tasto premuto dall’utente venga ignorato. 
L’applicazione che vuole analizzare i caratteri provenienti dalla tastiera, deve 
aggiornare 'keyVector con l’indirizzo di una propria routine che gestisca i caratteri 
ricevuti in input dall’utente. Nel nostro esempio, keyVector conterrà l’indirizzo della 
routine OurInGetString, e verrà aggiornato da OurGetString. 

Quando l’utente preme un tasto, la routine InterruptMain che in genere gestisce gli 
interrupt di GEOS, aggiorna la variabile keyData con il codice del carattere premuto. 
InterruptMain compie questo controllo ogni sessantesimo di secondo. Durante 
MainLoop, GEOS accede a un flag, preventivamente elaborato da InterruptMain, per 
sapere se è stato premuto un tasto dall’utente, e in caso positivo chiama la routine 
puntata da keyVector (nel nostro caso OurInGetString). Essa può accedere a keyData 
per elaborare il carattere inviato dall’utente. 

In effetti, InterruptMain compie anche altre operazioni. Se l’applicazione mantiene 
il controllo del processore per troppo tempo, non può essere eseguita MainLoop in 
quanto il 6510 non è in grado di gestire due operazioni contemporaneamente. Di solito 
i codici dell’applicazione compiono operazioni brevi, e restituiscono il controllo del 
processore a MainLoop dopo pochissimo tempo. Può però accadere che MainLoop non 
venga eseguita per un tempo abbastanza lungo, e che l’utente riesca nel frattempo a 
premere più di un tasto. Sembra quindi che si possano perdere alcune informazioni 
provenienti dalla tastiera. GEOS risolve questo problema mantenendo in un buffer 
(coda) tutti i caratteri che MainLoop non è riuscita ancora a leggere. Se InterruptMain 
riceve un carattere dalla tastiera e osserva che MainLoop non ha ancora avuto la 
possibilità di elaborare l’ultimo ricevuto, salva il codice del carattere in un buffer 
interno. In seguito, la routine di servizio della tastiera (OurInGetString) può chiamare 
la routine GetNextChar per svuotare il buffer interno della routine di interrupt. Ogni 
volta che viene eseguita, GetNextChar restituisce il successivo carattere memorizzato 
nel buffer di interrupt. Quando il buffer è stato interamente svuotato, GetNextChar 
restituisce il valore 0. 

OurInGetString legge il primo carattere dalla variabile keyData, e successivamente 
preleva i rimanenti caratteri dal buffer di interrupt tramite un loop che chiama 
ciclicamente GetNextChar. Ogni volta che OurInGetString riceve un carattere' lo 
memorizza nel nostro buffer di input, inBuffer, e ne genera l’eco sullo schermo. Per 
eseguire quest’ultima operazione, OurInGetString utilizza la routine PutChar. PutChar 
richiede il codice del carattere da visualizzare e le coordinate x e y del punto in cui 
disegnarlo sullo schermo. La posizione può essere una qualunque di quelle ammesse: 
(0-319) per la coordinata x e (0 - 199) per la coordinata y. PutChar è utilizzata per 
questo scopo anche da GetString e PutString. 
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È anche possibile utilizzare stringFaultVec per manipolare i caratteri che eccedono 
i Umiti dello schermo o i margini prestabiliti. Quando PutChar tenta di visualizzare un 
carattere che oltrepassa uno dei margini fìssati da leftMargin e da rightMargin, 
chiama la routine puntata da stringFaultVec. PutChar si preoccupa anche di 
mascherare, durante la visualizzazione, le parti di carattere che oltrepassano i limiti 
verticali impostati da windowTop e windowBottom. Quindi, i caratteri che si trovano 
lungo i due limiti verticali possono apparire troncati. Questa caratteristica si può 
utilizzare, ad esempio, per effettuare lo scroll verticale di un testo aU’interno di una 
finestra. 

Si può realizzare la routine puntata da stringFaultVec (che nel nostro esempio 
-chiameremo QurStringFault) in modo che effettui lo scroll orizzontale del testo 
aH’interno della fìnestra, o in modo che mandi automaticamente a capo l’intera parola 
(word wrap), quando oltrepassa in parte i limiti della finestra. Nel primo caso, le 
variabili windowTop, windowBottom, leftMargin e rightMargin definiscono le 
dimensioni della fìnestra aU’interno della quale si desidera effettuare lo scroll 
orizzontale di un testo di dimensioni maggiori. Quando l’utente inserisce un carattere 
che oltrepassa il limite destro della fìnestra, la routine puntata da stringFaultVec può 
cancellare il contenuto della fìnestra e visualizzare l’ultimo carattere battuto sulla 
stessa riga in modo da creare lo spazio per scrivere la parte destra del testo. La stessa 
operazione, anche se in modo più articolato e complesso, è compiuta da geoWrite per 
passare dal lato sinistro dello schermo a quello destro, e viceversa. Nel secondo caso 
quando l’utente batte un carattere che oltrepassa i limiti della fìnestra, la routine 
puntata da stringFaultVec riprende l’intera parola e la riscrive a capo, cancellandola 
ovviamente dalla riga precedente. 

La nostra routine QurStringFault esegue quest’ultima operazione semplificandola: 
porta a capo solo il carattere che supera il margine, e non l’intera parola di cui fa parte. 
Per fare questa operazione QurStringFault deve sommare alla coordinata verticale y 
dell’ultima riga l’eiltezza della riga stessa, ottenendo così la nuova coordinata verticale 
y alla quale riprendere la visualizzazione dei caratteri. La posizione orizzontale è data 
da leftMargin. Quando la routine puntata da stringFaultVec ritorna, deve comportarsi 
come se fosse stata chiamata da PutChar. In effetti QurInGetString non deve accorgersi 
di questa chiamata. QurInGetString non si deve preoccupare se i caratteri che 
visualizza in eco oltrepassano i margini perché non rientra nei suoi compiti. La routine 
puntata da stringFaultVec deve riordinare le cose in maniera tale che QurInGetString 
possa continuare a svolgersi come se nulla fosse accaduto. Tutto quello che 
QurInGetString deve sapere è che chiamando PutChar il carattere viene visualizzato. 

Per ricapitolare brevemente, OurGetString attiva il cursore visibile, azzera l’indice 
del buffer e aggiorna i vettori keyVector e stringFaultVec rispettivamente con gli 
indirizzi delle routine OurInGetSting e QurStringFault. In questo modo QurGetString 
inizializza l’evento. Qra, ogni volta che l’utente preme un tasto, MainLoop manda in 
esecuzione QurInGetString, la quale preleva i caratteri digitati accedendo a keyData 
e chiamando GetNextChar, memorizza i caratteri nel buffer inBuffer, produce sullo 
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schenno l’eco del carattere selezionato e aggiorna la posizione del ctirsore visibile. Se 
si raggiunge la fine della riga prima che l'utente abbia premuto il RETURN, 
OurStringFault visualizza il carattere sulla riga successiva, in modo del tutto 
indipendente da OurInGetString. 

La routine inizia con una chiamata a PutString per visualizzare un messaggio rivolto 
all’utente. 

OurCetString: 


jsr 

i-PutString 

jchiana la routine 

.word 

XPOSPROMPT 

scoordinata x (8 - 319) 

.byte 

YPOSPROMPT 

scoordinata y (8 - 199) 

.byte 

“Scrivi quello che vuoii", 8 

scessaggio da visualizzare per l'utente 
sii codice prosegue da questo punto 


Adesso bisogna abilitare la visualizzazione del cursore visibile. Si devono dichiarare 
le dimensioni della barra verticale lampeggiante e la sua posizione iniziale sullo 
schermo. Dal momento che stiamo utilizzando la fonte carattere standard di GEOS, che 
è alta 9 punti, fissiamo in 12 punti l’altezza verticale del cursore visibile. Le coordinate 
X e y della posizione iniziale conviene determinale sperimentalmente. Per adesso 
chiamiamo le due coordinate x e y XPOSPROMPT e YPOSPROMPT, riservandoci di 
valutare i valori corretti in seguito. 

XPOSPROMPT = valore di x (8 - 319) 

YPOSPROMPT = valore di y (8 - 199) 

Per attivare il cursore visibile dobbiamo chiamare la routine PromptOn. Il cursore 
visibile è realizzato con lo sprite 1. 


Ida 

#12 

saltezza del cursore visibile 


jsr 

InitTextProBPt 

sinizializza il cursore visibile, ma 

non lo visualizza 

LoadM 

StringX,XPOSPROMPT 

spassa le coordinate x e y del punto 

in cui visualizzare 

LoadB 

StringY,YPOSPROMPT 

sii cursore visibile 


Jsr 

PromptOn 

sattiva il cursore visibile 


Ida 

#8 

sazzera l'indice del buffer che viene 

utilizzato 



sda OurInGetString (routine che verrà 
snelle prossime pagine) 

' descritta 

sta 

a8 

sa8 e' lo pseudoregistro che contiene 
sdel buffer 

1'indice corrente 


Per determinare la posizione alla quale visualizzare il cursore, PromptOn utilizza le 
variabili stringX e stringY. Il cmsore adesso è visibile. Per finire, OurGetString deve 
inizializzare l’evento tramite Taggiornamento dei vettori keyVector e stringFaultVec. 
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LoadH keyVector, OurInGetString jimposta la routine di servizio 

LoadM stringFaultUec,OurStringFault ; imposta la routine d'errore 

rts jOurGetString ha impostato i vettori keyyector 

;e stringFaultVec e restituisce il controllo 
ja MainLoop; da questo momento, quando l'utente 
;preme un carattere, MainLoop esegue 
;l3 routine OurInGetString 

Diamo uno sguardo più approfondito a OurInGetString. Inizia prelevando il primo 
carattere da keyVector e se si tratta di un ritorno carrello (RETURN) conclude la sua 
esecuzione azzerando i vettori keyVector e stringFaultVec, in modo che MainLoop non 
esegua più alcuna routine se l'utente preme altri tasti. Se il carattere non è un ritorno 
carrello, OurInGetString lo visualizza in eco sullo schermo tramite PutChar, e lo 
memorizza nel buffer di input inBuffer. Successivamente chiama GetNextChar per 
ricevere i caratteri in coda, finché non riceve il carattere NULL (0). A questo pimto 
restituisce il controllo a MainLoop in modo che possano essere elaborati altri eventi, 
fino alla successiva pressione ^ un tasto da parte dell’utente. Ogni volta che 
OurInGetString genera l’eco del carattere sullo schermo, aggiorna anche la posizione 
dei cursore visibile, facendolo avanzare di un numero di pixel pari alla larghezza 
dell’ultimo carattere visualizzato. Per ottenere questo spostamento è sufficiente 
aggiornare la posizione orizzontale del cursore visibile con la coordinata x indicata in 
rii. Dal momento che utilizziamo stringX e stringY per fissarala posizione iniziale del 
cursore visibile, continuiamo a utilizzarle anche per il movimento. I codici di 


OurInGetString sono: 


OurInGetString! 


Idx 

a0 

jpreleva l'indice per puntare i caratteri nel buffer 

Ida 

KeyData 

jpreleva il primo carattere 

Charloop: 

cmp 

#CR 

^controlla se l'utente ha terminato la stringa 

beq 

Endstring 

;se e' cosi', termina-l'esecuzione della routine 

sta 

inBuffer, x 

;fflemorizza il carattere nel buffer di input 

pha 


;salva il carattere 

inx 


jpunta al successivo byte del buffer di input 

MoveB 

StringY, rlH 

Jpreleva la posizione dell'eco del carattere 

lloveM 

StringX, rii 

jdalle variabili di posizione del cursore visibile 

pia 


; recupera il valore del carattere 

jsr 

PutChar 

jgenera l'eco del carattere sullo schermo 
jPutChar restituisce la nuova posizione del carattere 
^successivo in rlH e rii 
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IloveU 

rii, StringX 

;aggiorna la coordinata x del cursore visibile 

MoveB 

rlH, StringY 

janche la coordinata y del cursore dev'essere variata, 
jdal momento che PutChar, tramite OurStringFault, 
jpuo' aver mandato a capo la riga 

jsr 

PromptOn 

;aggiorna la posizione del cursore visibile 

jsr 

GetNextChar 

;preleva il carattere successivo dalla coda 

cmp 

#0 

^controlla se e' il carattere NULL (0) 

bne 

Charloop 

;se non e' NULL ripeti 

stx 

a0 

jmemorizza nuovamente l'indice del buffer per successive 
jchiamate di OurInGetString effettuate da MainLoop 

rts 


; restituisce il controllo a MainLoop in modo che questa possa 
^dedicarsi ad altri eventi 

EndStringi 


Ida 

#0 

; termina la stringa di input 

sta 

inBuffer, x 

;contenuta in inBuffer 

LoadU 

keyVector, #0 

;azzera i due vettori 

LoadU 

StringFaultVec, #0 



rts 

Questa è la struttura base per poter inserire dei caratteri da tastiera, memorizzarli 
in un buffer e generare l'eco sullo schermo. Può accadere che OurInGetString provi a 
visualizzare un carattere oltre il margine destro indicato da rightMargin. In questo 
caso, indipendentemente dal codice di OurGetString, PutChar cede il controllo alla 
routine d’errore puntata dal vettore stringFaultVec. Nel nostro esempio la routine 
d’errore si chiama OurStringFault. L’operazione che deve svolgere consiste nell’ag- 
giornare le coordinate x e y del cursore visibile all’inizio della nuova riga e fare in modo 
che i caratteri successivi siano visualizzati a capo. Per aggiornare la coordinata y alla 
posizione della nuova riga, OurStringFault deve conoscere la dimensione verticale (il 
corpo) del set di caratteri che si sta ussmdo. Il modo più facile per ottenere questa 
informazione è chiamare la routine GetRealSize. OurStringFault deve memorizzare 
temporaneamente il carattere che non può essere visualizzato sulla riga corrente, e 
ottenere la dimensione verticale chiamando GetRealSize. A questa dimensione 
verticale conviene aggiungete due linee di scansione per spaziare meglio le due righe. 
Il risultato dev’essere memorizzato in stringY. Per quanto riguarda stringX, dev’essere 
semplicemente aggiornata con il valore contenuto in leftMargin. A questo giunto il 
carattere che non è stato visualizzato, perché avrebbe oltrepassato il margine destro, 
viene disegnato sulla nuova riga. Compiuta quest’ultima operazione, OurStringFault 
cede definitivamente il controllo alla routine OurInGetString, che è completamente 
indifferente a quanto è successo. 
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OurStringFaultI 


pha 


;salva il earattere aneora da visualizzare 

Idx 

eurrentMode 

;lo stile eorrente può' influire sull'altezza del earattere 

jsr - 

txa 

eie 

GetRealSize 

;preleva la dimensione vertieale del earattere 
jl'altezza e' restituita in x 

ade 

•stringY 

jaggiunge l'altezza del earattere alla posizione y 
jdella riga eorrente 

ade 

#2 

jaggiunge due ulteriori linee di seansione per migliorare 
; la spaziatura 

sta 

StringY 

jmemorizza la posizione y della nuova riga 

LoadM 

pia 

stringX,leftMargin 

^aggiorna la eoordinata x della nuova riga 
jriprende il earattere da visualizzare 

jsr 

rts 

PutChar 

;lo visualizza all'inizio della nuova riga 


Le due routine che abbiamo appena illustrato permettono di gestire con facilità le 
stringhe di caratteri in input dall'utente. La stringa in input è memorizzata nèi buffer 
inBufier. È relativamente semplice espandere OurGetString in modo che diventi 
equivalente alla funzione GetString: si tratta di fare in modo che OurGetString sia in 
grado di ricevere, in input dalla chiamata, l’indirizzo del buffer ove memorizzare i 
caratteri, il massimo numero di caratteri che il buffer può conterìere, l’indirizzo della 
routine d’errore e quello della routine da eseguire quando finisce l’input. 

Prima di procedere a illustrare nuovi argomenti, dobbiamo sottolineare una 
fondamentale differenza fra GetString e OurGetString. Quando l’applicazione chiama 
GetString, le passa anche l’indirizzo della vera e propria routine di servizio che il 
sistema deve eseguire quando l’utente ha premuto il RETURN. GetString memorizza 
l’indirizzo di questa routine nella variabile string. Se l’utente non batte il RETURN, dal 
punto di vista dell’applicazione non avviene alcun evento, dal momento che i suoi 
codici non vengono eseguiti. Solo quando viene premuto il RETURN l’evento si 
completa e la routine di servizio dell’applicazione può accedere al buffer per leggere 
l’input. Per fare in modo che OurGetString si comporti allo stesso modo, dobbiamo 
inserire dopo EndString e prima dell’istruzione rts la chiamata alla routine di servizio 
dell’evento. 

Dopo aver illustrato come può avvenire la gestione delle stringhe in input 
dall’utente, il passo successivo consiste nell’introdurre il cambio dello stile di scrittura 
della fonte carattere e del set di caratteri. Prima di introdurre questi nuovi argomenti 
presentiamo le routine impiegate nell’esempio che abbiamo appena trattato. 





Funzione: Restituisce un carattere dalia coda di tastiera. Quando la coda è stata 

interamente svuotata, la routine restituisce il valore 0. 

indirizzo: $C2A7 

Parametri: Nessuno 

Restituisce: a carattere proveniente dalla coda di tastiera, o 0 se la coda è vuota 

Distrugge: x 

Sinossi: GEOS memorizza in un buffer i caratteri provenienti dalla tastiera. Quando 

il loop di MainLoop è in ritardo, per qualunque ragione, l’utente può digitare 
più di un carattere prima che MainLoop abbia avuto il tempo di leggere 
l’ultimo. Ogni volta che GetNextChar viene eseguita, restituisce in a il codice 
ASCII del carattere prelevato dalla coda di tastiera. Se la coda è vuota, a 
viene restituito con il valore 0. Normalmente le applicazioni devono essere 
in grado di ricevere tutti i caratteri digitati dall’utente, e quindi copiano il buffer 
interno di GEOS nei loro buffer opportunamente predisposti, chiamando la 
routine GetNextChar finché questa non restituisce il valore 0. 






Funzione: FYepara le dimensioni dd cursore visibile (la barra verticale che individua il 

punto in cui viene visuali 2 zato il nuovo carattere). 

Indirizzo: $C1CX) 


Parametri: a dimensione verticale in pixel del cursore visibile 

Restituisce: Niente 

Distrugge: a, x, y 

Sinossi: Per visuaii 22 are il cursore visibile si usa di solito una barra verticale 

lampeggiante, del tipo considerato nell’analisi di GetString. InitTextPrompt 
crea H cursore visibile della dimensbne verticale specificata in a. Il cursore 
viene realizzato con lo sprite 1. InitTextPrompt prepara, ma non visualizza, 
il cursore visibile. 






Funzione: Visualizza il cursore visibile alle coordinate stiingX e stringY. 

Indirizzo: $C29B 


Parametri: stringX coordinata x, in pixel, alla quale attivare il cursore visibile 

(0 - 319) 

StringY coordinata y, in pixel, alla quale attivare il cursore visibile 
(0 -199) 

Restituisce: Niente 
Distrugge: a, x, r3L, r5L, r6 

Sinossi: PromptOn attiva il cursore visibile (sprite 1) visualizzandolo alla posizione 

individuata da stringX e strir^Y. H cursore visibile dev’essere già stato 
inizializzato con una chiamata alla routine InitTextPrompt. 






Funzione: Disattiva il cursore visibile sullo schermo. 


Indirizzo: $C29E 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, x, r3L 

Sinossi: PromptOff serve per disabilitare il cursore visibile. Per usarla si devono 

adottare alcuni accorgimenti. Chiamare PromptOff con la seguente 
procedura: 

php 

sei 

jsr ProBptOff 

LoadB alphaFUgj 0 

eli 
plp 

alphaFlag contiene alcuni bit che governano il cursore visibile. Se il bit 7 
è impostato a 1 il cursore visibile è attivato e il bit 6 ne sorveglia lo stato. 
Mentre il cursore lampeggia, il bit 6 contiene l’informazione di acceso o 
spento. Quando è impostato a 0 il cursore visibile è invisibile (non è un gioco 
di parole). I restanti 6 bit costituiscono un contatore per determinare il ritmo 
del lampeggio. 

Chiamando PromptOff si disabilita il cursore visibile. Impostando 
alphaFlag a 0, GEOS non riattiva il cursore. 






Funzione: Visualizza un carattere sullo schermo. Dispone di speciali caratteri escape, 

per il controllo della visualizzazione. 

Indirizzo: $C145 


Accede a: dispBufferOn 

bit 7 se è impostato a 1 scrive sullo schermo principale 
bit 6 se è impostato a 1 scrive sul buffer di schermo 
currentMode il carattere è visualizzato con lo stile corrente 

Parametri: a codice ASOi del carattere (0 - 96) 

r11 coordinata x del punto in cui viene visualizzato il carattere (0 - 319) 
rIH coordinata y del punto in cui viene visualizzato il carattere (0 -199) 

Restituisce: ri 1 coordinata x della posizione in cui viene visualizzato il carattere 
successivo 

rIH coordinata y della posizione in cui viene visualizzato il carattere 
successivo 

Distrugge: a, x, y, rO, r2 - rIO, ri 2 - ri 3 

Sinossi: PutChar visualizza un carattere ASCII sullo schermo nella posizione 

individuata dalle coordinate x e y, ed è anche in grado di interpretare alcuni 
(ma non tutti) caratteri escape per il controllo della stampa sullo schermo. 
Essa restituisce in rii e rIH le coordinate x e y del punto in cui sarà 
visualizzato il nuovo carattere. Chiamando nuovamente PutChar (digitando 
cioè un altro carattere), questo verrà visualizzato subito dopo il precedente. 

Sono molti i caratteri escape riconosciuti da PutString, che PutChar non 
è in grado di interpretare. In particolare si tratta dei caratteri escape composti 
da due o più byte, dal momento che PutChar accetta un carattere alla volta 
nel registro a. 
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Caratteri escape riconosciuti da PutChar 


Carattere 

ASCII 

Funzione 

NULL 

e 

Carattere che conclude una stringa 

BflCKSPflCE 

8 

Cancella il carattere precedente, la cui larghezza e' meiBorizza- 
ta in lastMidth (18897). Se l'applicazione non aggiorna lastUidth 
con la larghezza del carattere che precede quello appena cancel¬ 
lato, questa funzione di controllo opera solo la prima volta 

FORWflROSPflCE 

9 

Muove il cursore verso destra di uno spazio 

LF (line 

feed) 

10 

Muove il cursore di una riga verso il basso (il numero di pixel 
viene prelevato dalla variabile curHeight) 

HOME 

11 

Muove il cursore all'angolo superiore sinistro dello schermo 

UPLINE 

12 

Muove il cursore di una linea verso l'alto (il numero di pixel 
viene prelevato dalla variabile curHeight) 

CR (carriage 
return) 

13 

Muove il cursore all'inizio della riga successiva; la coordinata 

X e' aggiornata con il valore contenuto in leftMargin e viene 
automaticamente eseguito un LF 

ULINEOH 

14 

Attiva lo stile sottolineato 

ULINEOFF 

15 

Disattiva lo stile sottolineato 

REV-ON 

18 

Attiva lo stile negativo 

REV-OFF 

19 

Disattiva lo stile negativo 

BOLOON 

24 

Attiva lo stile nero 

ITALI CON 

25 

Attiva lo stile corsivo 

OUTLINEON 

28 

Attiva lo stile outline 

PLRINTEXT 

27 

Disattiva ogni stile precedentemente attivato, Lo stile 
con il quale i caratteri sono visualizzati diventa il tondo 


Se si vuole visualizzare un carattere fuori dal range imposto da leftMargin 
e rightMargin, PutChar chiama la routine d’errore puntata dal vettore 
stringFaultVec. L’applicazione deve prevedere una propria routine d’errore, 
altrimenti il carattere che oltrepassa i margini non viene visualizzato. Di solito 
la routine d’errore realizzata dall’applicazione controlla il valore contenuto in 
windowBottom e, se possibile, visualizza i caratteri sulla riga successiva. Ma 
questa è un’operazione semplice. La routine d’errore può essere anche 
molto più sofisticata: per esempio può riportare a capo le parole che 
oltrepassano i margini. PutChar effettua anche alcuni controlli con i limiti 
verticali windowTop e windowBottom. Se una qualunque parte del carattere 
da visualizzare oltrepassa i limiti windowTop o windowBottom, quella parte 
viene mascherata. In questo modo la visualizzazione di caratteri può essere 
limitata a una finestra senza che i limiti siano oltrepassati. 







Funziona: Visualizza il carattere e aggiorna la coordinata x. 

Indirizzo: $C202 


Parametri: a codice ASCII del carattere da visualizzare 

r11 coordinata x della posizione in cui visualizzare il carattere (0 - 319) 
rIH coordinata y della posizione in cui visualizzare il carattere (0 -199) 

Restituisce: ri 1 coordinata x della posizione in cui visualizzare il carattere successivo 
rIH invariato 

Distrugge: a, x, y, ri), r2 - rIO, ri 2, ri 3 

Sinossi: SmalIPutChar è una subroutine di PutChar. A differenza di PutChar, non 

prevede alcun controllo sulla posizione del carattere da visualizzare, ed è 
quindi l’applicazione a dover provvedere in modo autonomo. Non è in grado 
d'interpretare i caratteri escape di controllo e quindi si possono passare solo 
caratteri visualizzabili. Dopo aver visualizzato il carattere, SmalIPutChar 
provvede ad aggiornare la coordinata x, contenuta in ri 1, per determinare 
quale dovrà essere la posizione del carattere successivo sulla stessa riga. 
Si tratta di una routine che manipola i caratteri con grande rapidità. 






Funzione: Restituisce le dimensioni, verticale e orizzontale, del carattere selezionato, 

tenendo conto dello stile prescelto. 

Indirizzo: $C1B1 


Parametri: a il codice ASCII del carattere ($20 - $60) 

X lo stile prescelto. Il byte deve avere la stessa struttura della variabile 
currentMode 

Restituisce: y larghezza del carattere 

X altezza del carattere 

a offset dalla linea di base del carattere 

Distrugge: Niente 

Sinossi: GetRealSize restituisce l’altezza e la larghezza di un carattere del set 

correntemente selezionato, tenendo conto dello stile specificato nel registro 
X. L’offset dalla linea di base del carattere è la distanza dalla linea di base 
alla massima altezza presente nella fonte. Il calcolo per ottenere questa 
distanza è: BaseLineOffset = (altezza totale - discendente). GEOS mantiene 
questo valore nella variabile baselineOffset, e lo aggiorna a ogni cambio di 
corpo o fonte. 

Ecco gli stili che cambiano le dimensioni dei caratteri. 

Nero (Bold): aumenta la larghezza dei caratteri di un pixel 

OutLine; aumenta l’altezza dei caratteri di due pixel e quindi aggiunge 
anche due pixel alla dimensione BaseLineOffset 

Corsivo (Italie): inclina i caratteri. Deforma un ideale rettangolo contenente 
il carattere, facendolo diventare un parallelogramma. La larghezza non varia. 
Le linee di scansione che compongono il carattere vengono spostate a 
destra di un pixel ogni due linee, iniziando dalla linea di base. La linea di base 
rimane inalterata, le due linee sovrastanti vengono spostate a destra di un 
pixel, le due successive vengono spostate a destra di due pixel rispetto alla 
posizione originale e cosi via. Le linee al di sotto della linea di base vengono 
spostate verso sinistra. 






GetCharWidth 

Funzione: Restituisce la larghezza del carattere setezionato, tenendo conto dello stile 

impostato nella variabile currentMode. 


Indirizzo: $C1C9 

Accede a: currentMode lo stile correntemente impostato 

Parametri: a il codice ASCII del carattere ($20 • $60) 

Restituisce: a larghezza del carattere, oppure 0 se il carattere è un carattere di 

controllo (char < $20) 

Distrugge: y 


Sinossi: 


Questa routine restituisce la larghezza del carattere tenendo conto dello stile 
impostato. 
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n controllo dello stile 

visualizzare i caratteri in nero, corsivo o uno quedunque degli altri stili è 
un’operazione semplice. È sufficiente passare a PutChar il relativo carattere escape per 
impostare lo stile desiderato. I caratteri escape sono descritti nella scheda della routine 
PutChar. PutChar si rende conto che si trova di fronte a un carattere escape e non prova 
a visualizzarlo sullo schermo. Si limita ad aggiornare la variabile currentMode per 
impostare il nuovo stile. Ogni bit della variabile currentMode rappresenta uno stile 
selezionabile. Passando a PutChar un carattere di controllo per attiveue un nuovo stile, 
viene impostato a 1 il corrispondente bit nella variabile currentMode. Così possono 
essere selezionati più stili contemporaneamente. Passando il carattere di controllo 
corrispondente allo stile tondo (plaintext) si ottiene l’azzeramento di tutti i bit di 
currentMode, e quindi la disattivazione di tutti gli stili. 

Qualche problema in più lo presentano le variazioni di fonte. L’applicazione 
dev’essere in grado di manipolare le fonti carattere in modo autonomo. Deve saper 
interpretare un comando di cambio della fonte inserito aU’intemo del testo, ma deve 
inoltre saper riconoscere un comando diretto dall’utente, espresso selezionando la voce 
di un menu o un’icona. 

Una stringa di caratteri visualizzata da PutString non ha limiti nel numero di 
caratteri escape che può contenere. Ogni stile di scrittura, escluso il tondo, si aggiunge 
a quelli già selezionati. Lo stile tondo rimuove tutti quelli già impostati. Per esempio, 
la seguente stringa di caratteri: 

TextExaisplei .byte PLftINTEXT,"Tondo,",B0LD0N,“ Nero,",ITflLICON," Nero e 
Corsivo,",PLftINTEXT,0 

Visualizza la seguente scritta: 

Tondo, N«ro, Nero e Corsivo. 

TextExample conclude la sua visualizzazione lasciando azzerati tutti gli stili, cioè 
selezionando lo stile tondo. 

Quando si preleva una stringa in input dall’utente tramite la routine GetString, tutti 
i caratteri non direttamente stampabili, a parte il carattere BACKSPACE, vengono 
filtrati (non hanno alcun effetto e non vengono memorizzati nel buffer). Se 
l’applicazione sta invece ricevendo i caratteri dalla tastiera tramite la variabile 
keyData e la routine GetNextChar, tutti i caratteri ASCII riescono a passare, compresi 
quelli con il bit 7 impostato a 1, ottenuti con la pressione simultanea del tasto 
Commodore. Quindi se l’utente preme il carattere di controllo che attiva lo stile nero 
(ASCII 24 ottenuto con il tasto CTRL e il tasto x) e l’applicazione sta prelevando la 
stringa con la nostra routine OurGetString, l’eco sullo schermo dei caratteri successivi 
sarà prodotto con raggiunta dello stile richiesto. Di sohto si vuole che OxirGetString 
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filtri alcuni ceiratteri non visualizzabili, perché non vengano passati a PutChar, che li 
interpreterebbe nel loro significato ASCII. 

Aggiungere il comando del cambio della fonte aU’intemo di un buffer di 
memorizzazione di un testo è semplice come inserire il comando di cambio di stile. È 
sufficiente inserire nel testo il carattere escape appropriato e i parametri che richiede. 
Benché esista, in ambiente GEOS, una sintassi per il comando di cambiamento delle 
fonti carattere, mancano le routine in grado di eseguire il comando. Per farlo, il Kernel 
di GEOS dovrebbe destinare un’opportuna quantità di memoria libera alle fonti 
carattere presenti su disco. Non sapendo a priori quali sono gli spazi disponibili e se 
sono sufficienti per contenere il set di caratteri selezionato (i set di caratteri possono 
occupare anche molta memoria), il Kernel di GEOS non può manipolare autonomamen¬ 
te il cambio di fonte. Nonostante questo, abbiamo ugualmente costruito una sintassi 
standard per il comando, in modo che particolari applicazioni non incontrino problemi 
di compatibilità nella gestione delle fonti carattere. Le applicazioni devono prevedere 
il comando di cambio della fonte nei loro buffer interni e routine in grado di 
interpretarlo. Approfondiremo quésto punto nel prossimo paragrafo. 


Le fonti carattere 

In ambiente GEOS, la dimensione che caratterizza un set di caratteri è l’altezza 
massima misurata in punti, il cosiddetto “corpo carattere". Viene comunemente 
assunto che la dimensione di un punto grafico sia 1/72 di pollice. Per ragioni di 
comodità pratica, in ambiente GEOS un punto grafico corrisponde a un pixel dello 
schermo, e un pixel misura 1/80 di pollice. Si tratta della grandezza che meglio si 
presta a essere impiegata con le stampanti in commercio, che per la maggior parte 
possiedono testine in grado di stampare 80 punti per pollice. 

In GEOS un set di caratteri è composto al massimo da 96 caratteri(t). In conformità 
con lo standard inglese, i caratteri visualizzabili sono individuati dai codici ASCII che 
vanno da 32 a 127.1 set di caratteri opportunamente creati per lingue straniere possono 
contenere alcuni simboli particolari e non possederne altri. La loro larghezza è 
variabile (la w, per esempio, è più larga della i), ma tutti hanno necessariamente la 
stessa altezza massima, che identifica il “corpo” del set di caratteri. In GEOS non ci 
soho limiti per le possibili altezze, mentre la larghezza non può superare i 54 pixel. 

Una “fonte carattere” è costituita da molti set di caratteri, diversi é di diverse 
dimensioni, ma accomunati dallo stesso stile dominante. La fonte di sistema, 
residente nel Kernel di GEOS, si chiama BSW ed è composta da un solo set di caratteri 
in corpo 9 (ricordiamo che il corpo non è altro che l’altezza massima misurata in pixel). 


(t) Un’eccezione a questa regola: la fonte carattere di sistema BSW 9 contiene 97 caratteri, e non 96 come 
tutte le altre. Il codice ASCII #128 corrisponde al marchio Commodore. 
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Uno specifico set di caratteri aH’interno di una fonte carattere è definito dal nome della 
fonte e dal corpo dei caratteri; BSW 9. La fonte carattere di sistema è sempre residente 
in memoria ed è parte integrante del Kernel di GEOS. Tutte le altre fonti disponibili 
sono memorizzate su disco e all’occorrenza possono essere caricate in memoria. 


L’identificatoFe della fonte carattere 

A ogni fonte carattere è associato un numero d’identificazione unico che per brevità 
chiamiamo ID. L’ID è un numero che occupa 10 bit. Quindi i numeri “consentiti" 
possono variare nel range 0 - 1023. 


L’identificatore del set di caratteri 

Ogni set di caratteri, nelTambito di una fonte, viene individuato tramite un numero 
che ne indica il corpo, e che occupa 6 bit. La combinazione dell’ID, e del numero 
d'identificazione del corpo, occupa 16 bit. Questo numero rappresenta l’identificatore 
del set di caratteri, e individua sia il numero della fonte (ID) sia il corpo del singolo 
set di caratteri aU’interno della fonte stessa. Chiamiamo per brevità “Font ID" 
l’identificatore del set di caratteri. 

Font ID: bit 15/6 = ID, bit 5/0 = corpo del set 


La struttura dei file delle fonti carattere 

Le fonti carattere sono memorizzate in file con struttura VLIR di tipo FONT (per 
maggiori informazioni sulla struttura VLIR, consultare il capitolo dedicato ai file in 
ambiente GEOS). Ogni set di caratteri della fonte corrisponde a un record del file, 
secondo la struttura VLIR. Il numero che identifica il set (cioè il corpo) è anche il 
numero del record nel quale il set viene memorizzato. Se la fonte carattere contiene 
un set da 12 punti, questo viene memorizzato nel record 12 (i record sono numerati a 
partire dal record 0, cioè quello individuato dai primi due byte dopo l’indirizzo T/S del 
blocco successivo). I record ai quali non corrispondono set di caratteri nella fonte 
restano inutilizzati; i loro puntatori T/S contengono rispettivamente i valori $00 e $FF. 
Le informazioni necessarie per utilizzare la fonte carattere sono memorizzate nel blocco 
File Header associato al file. Lo spazio utilizzato per queste informazioni viene 
normalmente impiegato per contenere dati che per un file di tipo FONT non hanno 
significato. 
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Il File Header delle fonti carattere 


Offset airintemo del Rie 
Header 


Numero Descrizione 
di byte 


O-GHSET-LENGTHS = 97 ($61) 33 

O-GHFONTID = 130 ($82) 2 

O-GHPOINT-SIZES = 132 ($84) 28 


Oinensioni in byte, memorizzate 
in word, di ogni corpo della 
fonte, dal piu' piccolo al piu' 
grande; le word sono sequenziali 
e il buffer dev'essere riempito 
con un opportuno numero di zeri 

Font ID del primo corpo della 
fonte, il piu' piccolo 

Font IO di tutti i corpi 
della fonte che seguono; 
il buffer dev'essere riempito 
con un opportuno numero di zeri 


Le posizioni dei byte specificate nella tavola includono l’indirizzo T/S; il primo byte 
del blocco (l’indirizzo di traccia) si trova in posizione 0. 

Come si può osservare nella tavola appena illustrata, il numero d’identificazione 
della fonte carattere (ID) è memorizzato nei byte 130 e 131 del File Header. Questo 
numero, memorizzato sotto forma di word, è anche l’identificatore del corpo principale 
della fonte (Font ID). Dal byte 132 del File Header inizia una tavola di 28 byte ( 14 word) 
contenente il Font ID per ogni altro set di caratteri disponibile per la fonte. Per esempio, 
la fonte Elmwood, le cui caratteristiche sono riportate in appendice, contiene due corpi 
carattere, il 18 e il 36. L’ID della fonte è il numero 20. La combinazione dell’ID e del 
corpo del primo set della fonte crea il primo Font ID. In questo caso il Font ID è $0512. 
Questa word dev’essere memorizzata a Q-GHFONTID (secondo la solita regola del 
byte basso e byte alto: $12, $05). A Q-GHPQINT-SIZES devono essere memorizzati i 
Font ID dei corpi che seguono nella fonte. In questo caso abbiamo solo un secondo 
corpo il cui Font ID è $0524. 

Riassumendo: tutti i Font ID relativi a ogni corpo della fonte, devono essere 
memorizzati, dal più piccolo al più grande, a partire dal byte Q-GHFONTID del File 
Header. Queste word devono essere sequenziali e i byte che restano devono essere 
azzerati. I numeri di byte occupati in memoria da ogni set di caratteri sono memorizzati 
nella tavola da 33 byte che inizia al byte 97 del File Header. Nel nostro esempio questa 
tavola conterrebbe due word sequenziali, ognuna delle (juali indica la lunghezza in 
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byte del set di caratteri corrispondente. Entrambe le tavole, la tavola dei Font ID e la 
tavola delle dimensioni in byte dei vari corpi, devono essere completate con zeri. Dal 
momento che, per ogni set, le word vengono occupate sequenzialmente a partire dalla 
prima, le ultime, che non corrispondono ad alcun set, devono essere azzerate. La tavola 
che inizia in posizione O-GHPOINT-SIZES ha una lunghezza massima di 28 byte, 
corrispondenti a 14 word; aggiungendo la word memorizzata a O-GHFONTID, risulta 
che 15 è il numero massimo di set di caratteri che una fonte può contenere. 

Come si utilizzano le fonti carattere 

Un set di caratteri, appartenente a una fonte, viene allocato in memoria come un 
blocco continuo di dati. Una volta che il set desiderato è stato caricato, per selezionarlo 
è sufficiente chiamare la routine LoadCharSet con il registro rO che contiene Tindirizzo 
in memoria del set. Per selezionare il set di caratteri di sistema, sempre residente in 
memoria, si deve chieunare la routine UseSystemFont. Le applicazione possono 
impiegare le fonti carattere in molti modi diversi. Se l’applicazione deve usare un solo 
set di caratteri, per esempio, è sufficiente che lo carichi in una parte della memoria 
appositamente allocata e non lo cancelli più. Se invece l’applicazione deve avere a 
disposizione diversi set di caratteri e diverse fonti (come geoWrite o geoPaiht), il 
programmatore dovrà prevedere alcune routine interne che carichino da disco il set 
desiderato. A questo proposito l’applicazione deve anche prevedere un sistema di 
selezione delle fonti e dei set comandato dall’utente. Come standard, geoWrite e 
geoPaint adottano un menu per ricevere dedl’utente le informazioni riguardo alla fonte 
e al set desiderato. 

Per essere più precisi, l’applicazione lascia nelle tavole di definizione dei menu uno 
spazio di 19 byte sizzerati per ogni voce; questo spazio corrisponde al testo che contiene 
l’indicatore dello stato della fonte (selezionata o non selezionata) e il nome. Il numero 
massimo di voci per questo menu è otto, quindi l’applicazione non è in grado di gestire 
sullo stesso disco più di otto fonti contemporaneamente. I primi due byte dei 19 
dispKDnibili per ogni nome di fonte, sono impiegati per descrivere all’utente lo stato 
della fonte. Se la fonte è correntemente selezionata, questi due byte contengono la 
stringa di testo “ * ” come marcatore. In caso contrario, questi due byte contengono due 
spazi. I successivi 16 caratteri sono il nome delle fonte carattere, mentre l’ultimo 
carattere è quello che conclude la stringa (0). 

Quando viene eseguita la routine d’inizializzazione dell’applicazione, viene anche 
fatta una chiamata alla routine di sistema FindFTypes (consultare il capitolo dedicato 
ai sistema dei file per una descrizione di questa routine), che crea una lista dei file di 
tipo FONT (nel nostro caso) presenti su disco. I primi otto nomi, corrispondenti alle 
prime otto fonti carattere presenti su disco, vengono memorizzati in uno spazio 
opportunamente predisposto aU’interno della tavola di definizione del menu. 
All’apertura del menu i nomi delle fonti presenti sul disco appaiono all’interno delle 
otto voci. 
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Il passo successivo che l’applicazione deve compiere per creare il supporto di 
gestione delle fonti carattere, è la creazione di una tavola in memoria che contenga i 
corpi disponibili per ogni fonte, e la verifica che lo spazio richiesto in memoria dai set 
di ogni fonte sia compatibile con le esigenze dell’applicazione. L’applicazione deve 
prelevare queste informazioni dal blocco File Header della fonte carattere presente su 
disco. Ogni volta che l’utente seleziona una voce del menu di scelta delle fonti, 
l’applicazione ricostruisce dinamicamente il sotto-menu che elenca i corpi disponibili 
per quella fonte, e lo Visualizza. Il tipo di sotto-menu impiegato per questa operazione 
è il DYN_SUB_MENU. Si realizza una struttura di menu tale che ogni sotto-menu è di 
tipo DYN_SUB_MENU e accede alla stessa routine di preparazione. 

Vediamo come agisce la routine di gestione dinamica dei sotto-menu. Innanzi tutto 
deve sapere da quale delle otto voci del menu è stata selezionata, per poter identificare 
il nome della fonte carattere. La routine riceve dal Kernel di GEOS il numero della voce 
selezionata, e lo utilizza come indice alLinterno della struttura del menu, per prelevare 
la stringa corrispondente al nome della fonte. Questo nome sarà utilizzato per 
individuare sul disco la fonte carattere. A questo punto la routine accede alla tavola 
precedentemente creata dalla routine d’inizializzazione, nella quale sono memorizzati 
tutti i corpi disponibili per ogni fonte. Il numero della voce selezionata viene impiegato 
ancora come puntatore per individuare i corpi disponibili, e creare così il sotto-menu 
di scelta dei corpi della fonte. 

Quando l’utente ha effettuato anche la scelta del corpo, la routine di servizio 
associata alle voci del sotto-menu riceve il numero della voce attivata. Questo numero 
individua il corpo prescelto, e quest’ultima informazione non è altro che il numero del 
record, aU’interno della struttura VLIR della fonte, che contiene il set desiderato 
dall’utente. Individuato il record, la routine di servizio lo carica in memoria. A questo 
punto il set di caratteri richiesto dall’utente può essere attivato. Per esempio, quando 
l’utente apre il menu di scelta delle fonti e seleziona la fonte “Roma”, la routine di 
servizio dinamica associata a tutte le voci del menu viene a sapere quale voce è stata 
scelta e preleva il nome della fonte. In seguito crea il sotto-menu contenente i vari corpi 
disponibili per quella fonte, prima che GEQS lo visualizzi. Quando queste operazioni 
sono state compiute, il sotto-menu viene visualizzato e l’utente può fare la sua scelta. 
La routine di servizio associata a tutte le voci del sotto-menu non deve far altro che 
determinare quale voce è stata selezionata, e realizzare un indice che punti, all’interno 
della struttura del sotto-menu, al valore del corpo prescelto. 

Qra l’applicazione possiede il nome della fonte e il numero del record da caricare in 
memoria. Deve quindi chiamare la routine QpenRecordFile passando il nome del file 
e il numero del record. Una volta che il set di caratteri è in memoria, come ultima 
operazione dev’essere chiamata la routine LoadCharSet che lo attiva e lo rende 
disponibile per l’utente. 

In appendice appare la lista di tutte le fonti carattere attualmente disponibili. 





Funzione: Attiva un particolare set di caratteri già residente in memoria. 

Indirizzo: $C1CC 


Parametri: rO indirizzo della fonte carattere in memoria 

Restituisce: Niente 

Distrugge: a, y, rO 

Sinossi: I set di caratteri sono caricabili da disco e richiedono uno spazio di memoria 

compreso fra 733 byte e 3970 byte. Diversi set possono risiedere in memoria 
simultaneamente, anche se provengono da fonti diverse. Per segnalare a 
GEOS quale fonte residente in memoria è correntemente attivata, viene 
eseguita LoadCharSet. Il registro rO deve contenere l’indirizzo al quale è stata 
caricata la fonte. 






Funzione: Seleziona la fonte carattere di sistema BSW 9, sempre residente in memoria. 

Indirizzo: $C14B 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, y, rO 

Sinossi: La fonte carattere BSW 9 è sempre residente in memoria. Dal momento che 

non ci sono indicatori che segnalano quale forrte è attualmente disponibile, 
è stata realizzata la routine UseSystemFont che offre un metodo rapido per 
selezionare la fonte carattere di sistema. 





7 1 DRIVER 
DI INPUT 


n driver di input standard 

Attuedmente GEOS dà la possibilità di utilizzare il joystick (il driver standard di 
input), il mouse proporzionale, la tavoletta grafica e la penna ottica. Sullo schermo, i 
comandi impartiti da questi dispositivi si riflettono in movimenti del mouse grafico 
(più semplicemente mouse). Il mouse sullo schermo è costituito da una freccia 
orientata verso l’alto e verso sinistra. Quando con la parola mouse si vorrà intendere 
il dispositivo hardware da tavolo, sarà esplicitamiente dichiarato. Conveniamo quindi 
che la parola mouse si riferisca alla freccia presente sullo schermo. Nel corso del 
capitolo adotteremo la parola “dispositivo” per indicare uno qualsiasi dei dispositivi 
hardware esterni sopra citati. 

A ogni chiamata di interrupt, la routine InterruptMain presente nel Kernel di GEOS 
dialoga con il driver di input, anch’esso residente in memoria. Il lavoro che il driver 
deve svolgere consiste nel calcolare i valori delle seguenti variabili. 

«ouseXPos word coordinata x del mouse sul campo visibile dello schermo (0 - 319) 

mouseYPos byte coordinata y del mouse sul campo visibile dello schermo (8 - 199) 

mouseData byte bit 7 impostato a 0 se il pulsante del mouse e' premuto, impostato a i 

se il pulsante del mouse non e' premuto 

pressFlag byte bit 5 (HOUSE-BIT) impostato a 1 se il pulsante del mouse cambia di stato 

bit 6 (INPUT-BIT) impostato a 1 se dalTultima chiamata di interrupt e' 

variata la posizione del mouse hardware 

Sia le applicazioni sia il Kernel di GEOS possono leggere i valori (xmtenuti in queste 
variabili e agire di conseguenza. Il Kernel accede al bit 5 (MOUSE-BIT) della variabile 
pressFlag per determinare se lo stato del pulsante ha subito una variazione. Se la 
variazione c’è stata, il Kernel accede alla variabile mouseData per sapere se l’evento 
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consiste in una pressione o in un rilascio del pulsante. Se il pulsante del mouse è stato 
premuto (mouseData diventa positivo), GEOS controlla se il mouse si trova sopra 
un’icona o un menu, e in questo caso esegue la routine di servizio associata. Altrimenti 
esegue la routine puntata dal vettore otherPressVec. 

Ma GEOS, cosa eibbastanza curiosa, gestisce anche il rilascio del pulsante del 
mouse. Infatti, quando si accorge che il suo stato è passato da premuto a rilasciato 
(mouseData diventa negativo), esegue ancora la routine puntata dal vettore 
OtherPressVec. È importante sottolineare che questa gestione avviene anche quando 
il mouse si trova su una regione significativa dello schermo. La routine puntata da 
OtherPressVec viene sempre eseguita: sia quando il mouse si trova su un'icona, o vi 
si trovava al momento della precedente pressione, sia quando si trova su una zona non 
significativa. Quindi, la routine puntata da otherPressVec dev'essere in grado di 
distinguere le pressioni del pulsante del mouse dai rilasci, e riconoscere se un rilascio 
si verifica dopo una pressione su una zona significativa oppure no. 

Questa caratteristica, che può apparire curiosa, si deve in realtà al fatto che la 
gestione del rilascio del pulsante del mouse è stata aggiunta relativamente in ritardo 
al Kernel di GEOS. I moduli di gestione dei menu e delle icone erano già completi. Però 
questo apparente bug offre in effetti un vantaggio: l’applicazione può reagire al rilascio 
anche cjuando la precedente pressione è avvenuta in una zona significativa dello 
schermo. In genere questa esigenza non si presenta, e quindi le routine puntate da 
OtherPressVec ignorano il rilascio del pulsante del mouse in qualunque posizione 
avvenga, o lo tengono presente solo quando avviene con il mouse non sovrapposto a 
un menu o a un’icona. Per fare un esempio, geoWrite impiega la gestione del rilascio 
per definire un blocco di testo quando l’utente mantiene premuto il pulsante del 
mouse. 


I compiti del driver di input 

Il driver di input ha principalmente il compito di “leggere” lo stato dell’hardware 
attraverso i byte hardwaue presenti nel C-64, e riportarne il valore nelle variabili 
mouseData e pressFlag. Il driver deve registrare il cambiamento di posizione del 
mouse e memorizzare le nuove coordinate nelle variabili mouseXPos e mouseYPos. 

Dal momento che i dispositivi hardware di input sono molto diversi fra loro, anche 
i metodi di accesso dei vari driver di input e i parametri significativi cambiano 
sostanzialmente caso per caso. Per fare un esempio, il driver per il joystick accede 
all’hardware leggendo la porta del joystick, e in seguito calcola l’accelerazione nella 
direzione indicata dal joystick. Dall’accelerazione può calcolare velocità e posizione 
finale. Nel caso di un mouse proporzionale, la gestione dei movimenti è totalmente 
diversa. Il mouse Commodore 1351 invia in output alla porta del joystick livelli di 
tensione diversi, e il processore SID, presente aU’interno del C-64, legge il livello di 
tensione memorizzando un numero da 8 bit per entrambe le coordinate x e y. Il driver 
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di input di gestione del mouse proporzionale legge questi due byte e ricava la nuova 
posizione del mouse. Non occorrono altri esempi per riconoscere quanto diversi 
possono essere i driver di input per i vari tipi di dispositivi hardware. Queste differenze 
devono comunque essere trasparenti per le applicazioni, alle quali interessa 
esclusivaunente che a ogni generazione di interrupt siano aggiornate le quattro 
variabili principali precedentemente citate. L’hardware di input adottato e il relativo 
tipo di driver di input, sono informazioni che devono risultare completamente invisibili 
per l’applicazione. Riducendo in questo modo i parametri di colloquio fra applicazione 
GEOS e dispositivo hardware di input, si raggiunge la massima compatibilità del 
sistema GEOS e delle applicazioni con qualsiasi tipo di dispositivo hardware di input. 

Locazioni fondamentali dei driver di input 

Lo spazio di memoria che GEOS mette a disposizione per contenere i codici del driver 
di input selezionato è di 380 byte e inizia all'indirizzo MOUSE-BASE ($FE80 - $FFF9). 
Appena installato, il sistema operativo GEOS contiene il driver di input standard del 
joystick. Quando l’utente seleziona un nuovo dispositivo hardware di input, 
all’indirizzo MOUSE-BASE viene caricato il corrispondente driver, disallocando 
completamente il driver precedente. Se si desidera realizzare un driver di input 
personalizzato, si deve rilocarlo all’indirizzo individuato da MOUSE-BASE. 

Tutte le appliceizioni GEOS compatibili si aspettano che il driver di input 
correntemente in memoria contenga tre routine fondamentali: InitMouse, SlowMouse 
e UpdateMouse. Oltre a queste routine fondamentali, le applicazioni si aspettano che 
il driver di input mantenga aggiornate le quattro variabili fondamentali; mouseXPos, 
mouseYPos, mouseData e pressFlag. Le tre routine fondamentali devono svolgere i loro 
compiti prescindendo dal tipo di driver di input al quale appartengono, e possono 
essere comunque allocate nello spazio di memoria occupato dal driver di input, dal 
momento che questo inizia con una tavola di salto (o jump table) che le individua 
univocamente; 

Indirizzo Contenuto 

MOUSE-BflSE jmp InitMouse 

MOUSE-BfìSE + 3 jmp SlowMouse 

MOUSE-BflSE + 6 jmp UpdateMouse 

Queste tre locazioni sono gli indirizzi ai quali il Kernel di GEOS e le applicazioni 
fanno riferimento per comunicare con il driver di input. Per esempio, se il Kernel 
desidera chiamare la routine UpdateMouse, deve eseguire l’istruzione jsr MOU¬ 
SE-BASE + 6 durante InterruptMain. La prima routine fondamentale che il driver di 
input deve possedere è InitMouse. Questa routine viene eseguita per inizializzare tutte 
le variabili interne ed esterne che il driver utilizza, prima che siano chiamate le altre 
routine. 





Funzione: Inizializza la configurazione hardware gestita dal driver di input corrente- 

mente in meiTìoria. 

Indirizzo: $FE80 (MOUSE-BASE) 

Parametri: Nessuno 

Restituisce: mouseXPos impostato al valore iniziale (0 - 319) 

mouseYPos impostato ai valore iniziale (0 -199) 
mouseData bit 7 impostato a 1 per indicare che il pulsante del mouse 
è in stato di rilascio 

Distrugge: a, x, y, rO - ri 5 (conviene assumere che tutti i registri siano stati distrutti dal 

momento che non è possibile sapere quali variabili potrebbero aver subito 
dei cambiamenti con il driver di input precedente) 
a, X, y, rO - r2, r7 - r8, per il driver del joystick 

Sinossi: Questa routine inizializza tutte le variabili richieste dal driver di input. Alcune 

variabili non sono direttamente accessibili e sono da considerare ad uso 
interno del driver. 

Dopo aver chiamato la routine InitMouse, è possibile eseguire le routine 
SlowMouse e UpdateMouse. 
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Accelerazione, velocità e variabili non standard 

Alcuni dispositivi di input, come il joystick, devono essere regolati secondo diversi 
livelli di sensibilità. Per esempio, qualche volta l’utente può desiderare che il mouse 
raggiunga la sua velocità massima in pochissimo tempo, mentre altre volte, come 
all'apertura di un menu, preferirebbe disporre di un mouse che si muove molto 
lentamente per poter agevolmente scegliete la voce desiderata, senza correre il rischio 
di chiudere il menu oltrepassandone i bordi. 

Altri dispositivi di input, come il mouse proporzionale e la tavoletta grafica, non sono 
gestiti attraverso il computo della velocità e dell’accelerazione, ma interagiscono 
direttamente con la posizione associata del mouse sullo schermo. Altri non ancora 
inventati potrebbero essere gestiti con variabili del tutto diverse. Tenendo presente 
queste considerazioni, appare evidente la necessità di svincolare il dialogo tra 
applicazione e dispositivo di input dalle attuali caratteristiche delle configurazioni 
hardware esterne. Il problema si risolve in tre parti. 

Per prima cosa, qualsiasi driver di input deve garantire alcune funzioni di base. 
Come minimo, queste funzioni devono mantenere aggiornate le quattro variabili 
fondamentali mouseXPos, mouseYPos, mouseData e pressFlag. 

In secondo luogo, possono essere allocate nella RAM dedicata alle variabili del 
sistema operativo GEOS alcune variabili addizionali per dispositivi simili al joystick. 
Il joystick è il dispositivo di default per quanto riguarda l’input dall’utente, e il suo 
driver ha bisogno di conoscere istante per istante velocità e accelerazione del mouse. 
Le variabili associate a questi due parametri di spostamento includono maxMouseSpe- 
ed, minMouseSpeed e mouseAccel, e vengono aggiornate con i loro valori di default 
dalla routine d’inizializzazione del driver di input. Il desk accessory Preference 
Manager può così facilmente accedere a tali variabili per intervenire sulla velocità di 
spostamento e l’accelerazione del mouse. La routine SlowMouse viene eseguita dal 
Kernel per riportare la velocità di spostamento del mouse a zero, per esempio durante 
l’apertura di un menu. SlowMouse e le variabili appena citate permettono di ottenere 
un controllo del joystick di elevata qualità. Può sembrare un tipo di controllo troppo 
sofisticato per un dispositivo come il joystick, ma ricordando che viene impiegato dalla 
maggior parte degli utenti, riteniamo che i nostri sforzi siano più che giustificati. 

Alcimi dispositivi di input, come il mouse proporzionale Commodore 1351, non 
richiedono speciali trattamenti. Il mouse proporzionale non si basa sulla velocità per 
impostare la nuova posizione, ma sulla distanza. Il suo movimento è di una tale 
precisione che consente di regolare molto accuratamente la posizione del mouse sullo 
schermo. Nel caso che in futuro diventi disponibile qualche nuovo dispositivo che 
necessiti di un trattamento speciale, abbiamo adottato un terzo tipo di approccio. 

Se le quattro variabili fondamentali non sono sufficienti per riportare tutte le 
informazioni di gestione del nuovo dispositivo hardware di input, si rende necessario 
allocare un nuovo spazio in memoria, per accogliere eventuali nuovi parametri. GEOS 
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consente ai driver di input d'impiegare, a questo scopo, i quattro byte che iniziano 
all’indirizzo inputData. Un'applicazione che oltre alla posizione, allo stato del pulsante, 
alla velocità e all'accelerazione del mouse deve ricevere altre informazioni dal driver 
dì input, le può leggere in questi quattro byte. Nota importante: le applicazioni che 
devono accedere alle variabiU allocate a inputData per completare le informazioni 
ricevute dal driver di input, diventano dipendenti dal particolare dispositivo di input, 
a meno di particolari accorgimenti. 

A ogni cambiamento di stato del dispositivo di input, il driver corrispondente deve 
svolgere le seguenti operazioni: 

1) aggiornare le quattro variabili fondamentali 

2) aggiornare i quattro byte a inputData, se impiegati 

3) impostare a 1 il bit INPUT-BIT (bit 6) della variabile pressFlag. 

Dal momento che di solito GEOS non accede a inputData, l’applicazione deve 
prevedere al suo interno una routine di lettura di queste variabili opzionali. L’indirizzo 
di questa routine dev’essere memorizzato nel vettore inputVector. Quando il Kernel di 
GEOS trova il bit INPUT-BIT della variabile pressFlag impostato a 1, chiama la routine 
puntata dal vettore inputVector (se non è azzerato). Per esempio, il driver del joystick 
memorizza nel primo byte e nel secondo byte a inputData la direzione e la velocità del 
mouse. Questi sono parametri opzionali per la gestione del mouse. geoPaint utilizza 
questi valori al suo interno per effettuare lo scroll del disegno. Quando l’utente 
seleziona il modo scrollMode, geoPaint memorizza nel vettore inputVector l’indirizzo 
della routine per realizzane lo scroll. Ogni volta che la direzione impostata dal joystick 
cambia, GEOS chiama il vettore inputVector e la routine interna di geoPaint 
interrompe lo scroll o ne cambia la direzione. 

Questo particolare impiego opzionale delle variabili a inputData non è così semplice 
per tutti i dispositivi di input. Per esempio, sebbene la direzione e la velocità di 
spostamento del mouse siano parametri naturali per il joystick, sono completamente 
atipici per dispositivi come il mouse proporzionale. I driver per questi dispositivi 
devono generare gli appropriati pauametri di direzione autonomamente, in modo che 
sia ancora possibile la piena compatibilità con l’applicazione geoPaint. 

L’unica ragione per impiegare le variabili opzionali a inputData è la gestione di un 
nuovo dispositivo di input nato per comunicare con un’applicazione specifica. Dal 
momento che questa particolare configurazione è incompatibile con altre applicazioni 
e altri dispositivi di input dall’utente, la scelta di questo terzo approccio dovrebbe 
essere ben ponderata. 

Le applicazioni possono leggere il contenuto della stringa allocata a inputDevName 
per conoscere il nome del driver di input in memoria in quel momento. L’interfaccia 
utente deskTop memorizza a inputDevName la stringa a terminazione nulla (17 byte) 
corrispondente al nome del driver di input. 
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A questo punto dovrebbe essere abbastanza chiaro quali sono i compiti 
fondamentali di un driver di input: 

1) determinare la posizione del mouse e le variabili di gestione del pulsante 

2) eventualmente aggiornare le variabili allocate a inputData 

3) memorizzare a inputData i due parametri direzionali se si desidera la piena 
compatibilità con geoPaint. 

Le variabili di cui abbiamo parlato in questa introduzione saranno discusse in 
dettaglio dopo la presentazione delle routine SlowMouse e UpdateMouse. 


La routine SlowMouse 

Come abbiamo già sottolineato, la routine SlowMouse imposta a zero la velocità del 
mouse, che in seguito può di nuovo aumentare. Non tragga in inganno il nome: la 
funzione di questa routine non è affatto quella di ridurre la velocità massima, indicata 
dalla variabile maxMouseSpeed. 

SlowMouse esiste principalmente per rendere più facile all’utente l’apertura di un 
menu o la selezione tra le sue varie voci. Quando l’utente apre un menu e seleziona 
una voce, il Kernel di GEOS apre il sotto-menu corrispondente e posiziona il mouse 
sulla prima voce. L’utente può poi selezionare una di queste voci. Ci siamo resi conto 
che la maggior parte degli utenti tengono il joystick iiiclinato nella direzione in cui 
deve apparire il sotto-menu, fino a quando questo non è stato interamente visualizzato. 
Dal momento che GEOS, durante la visualizzazione del sotto-menu, continua ad 
aggiornare le variabili del mouse tramite InterruptMain, è probabile che in quel lasso 
di tempo il mouse raggiunga la massima velocità di spostamento; può quindi accadere 
che quando GEOS posiziona il mouse sulla prima voce del sotto-menu, questo ne 
oltrepassi i bordi chiudendolo senza che l’utente abbia avuto il tempo di leggerlo. Si 
è quindi reso necessario provvedere a una routine che azzeri la velocità di spostamento 
del mouse in modo che questa situazione non possa verificarsi. I driver per il mouse 
o per la tavoletta grafica non utilizzano la velocità, ma devono ugualmente far ricorso 
a SlowMouse, anche se in questo caso viene eseguita solo l’istruzione rts. 

Se invece si desidera semplicemente ridurre la velocità di spostamento del mouse, 
l’applicazione deve diminuire il valore di maxMouseSpeed e mouseAccel. I valori 
standard per queste variabili sono riportati nelle pagine successive. 





Funzione: Riporta il mouse alla massima sensibilità, riducenctone la velocità a zero. 


Indirizzo: $FE83 (MOUSE-BASE + 3) 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a per il driver del joystick 

a, X, y, rO - r15 da assumere per qualsiasi altro driver di input 

Sinossi: Quando il mouse si muove sopra un menu, diventa qualche volta necessario 

fermarlo azzerandone la velocità. Questa routine non riduce la massima 
velocità impostata dalla variabile maxMouseSpeed, ma azzera la velocità di 
spostamento del mouse (se il driver è per il joystick). Subito dopo il mouse 
può riaccelerare fino a raggiungere di nuovo la massima velocità. 

Le versioni di SlowMouse attualmente disponibili nei driver della tavoletta 
grafica e del mouse proporzionale eseguono semplicemente l’istruzione rts. 
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La routine UpdateMouse 

UpdateMouse è la routine principale di un driver di input. I suoi compiti includono 
la “lettura" della porta che realizza il collegamento hardware con il dispositivo di input 
per determinare eventuali cambiamenti di stato, e il successivo calcolo delle variabili 
mouseXPos, mouseYPos, mouseData e pressFlag. Se il driver di input vuol essere 
completamente compatibile con l’applicazione geoPaint, deve aggiornare anche i 
parametri opzionali a inputData. A questo indirizzo si ricorre anche nel caso che siano 
richiesti parametri di comunicazione particolari. 
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UpdateMouse 

Funzione: 

Aggiorna le variabili di controllo del mouse. Viene eseguita dalia routine 
IntenruptMain a ogni chiamata di interrupt. 

Indirizzo: 

$FE86 (MOUSE-BASE + 6) 

Parametri: 

mouseXPos 

mouseYPos 

cialprb 

valore corrente della coordinata x del mouse 
valore corrente della coordinata y del mouse 
porta del joystick 

Restituisce: 

mouseXPos 

mouseYPos 

mouseOata 

pressFlag 

nuova coordinata x del mouse 
nuova coordinata y del mouse 
bit 7 impostato a 0 per indicare che il pulsante è premuto, 
a 1 per indicare che il pulsante è rilasciato 
MOUSE-BIT impostato a 1 se il pulsante del mouse ha 
appena cambiato il suo stato stato 

INPUT-BIT impostato a T se dall’ultima chiamata di 
interrupt si è verificato un cambiamento nell’input 
dall’utente 


inputData 

quattro byte aggiuntivi per parametri opzionali di gestione 
del driver di input. Nel caso del driver per il joystick, i primi 
due byte contengono i parametri direzionali 


inputData: 

bit 0 - 7 direzione del joystick: 0= destra 

1“ avanti e destra 

2= avanti 

3= avanti e sinistra 

4= sinistra 

5= indietro e sinistra 

6= indietro 

7= indietro e destra 
-1 = joystick centrato 


inputData + 1 

velocità corrente del mouse 

Distrugge: 

a, X, y, rO - r15 

per il joystick 
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Stoossi: Questa routine vi^ esegcàta a ogni chiamata di interrupt per aggiornare la 

posizione del mouse sullo schermo e leggere lo stato del pulsante; 
mouseXPos e mouseYPos vengono aggiornate a ogni chiamata di interrupt. 
Quando il pulsante del mouse cambia il suo stato, il bit MOUSE-BIT in 
pressFlag viene impostato a 1 ; mouseData diventa positivo se il pulsante è 
premuto (bit 7 = 0), negativo se è rilasciato (bit 7 = 1). Se il bit MOUSE-BIT 
è stato impostato dalla routine UpdateMouse, il Kernel di GEOS legge 
mouseData durante il suo ciclo in MainLoop per determinare se il 
cambiamento di stato del pulsante caratterizza una pressione o un rilascio. 
GEOS in seguito chianìa l’appropriata routine di sen/izio (che può essere per 
un’icona, per un menu o, attraverso otherPressVec, p)er la pressione del 
pulsante in una zona dello schermo non convenzionale) in base alla 
posizione del mouse sullo schermo. Al ritorno da questa routine, il bit 
MOUSE-BIT in pressFlag viene impostato a 0. 

Informazioni speciali provenienti dai dispositivo di input o generate dallo 
stesso driver devono essere passate a GEOS e alte applicazioni attraverso 
i quattro byte disponibili all’indirizzo inputData. Il bit INPUT-BIT in pressFlag 
dev’essere impostato a 1 quando uno di questi parametri speciali a 
inputData cambia il proprio v^ore. Durante MainLoop, GEOS chiama la 
routine puntata dal vettore inputVector se il bit INPUT-BIT è impostato a 1. 




160 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


Le variabili di gestione del mouse per il driver di input 

Il modulo di controllo del mouse gestisce diverse variabili. Alcune di queste variabili 
sono già state brevemente presentate. 

Variabili del nouse richieste 

mouseXPos word coordinata x della posizione del mouse sullo schermo visibile 

(0 - 319) 

mouseYPos byte coordinata y delia posizione del mouse sullo schermo visibile 

(8 - 199) 

mouseData byte bit 7 impostato a 1 se il pulsante e' rilasciato, impostato a 8 se 

il pulsante e' premuto 

pressFlag byte bit 5 (MOUSE-BIT) impostato a 1 dal driver di input se avviene 

un cambiamento nello stato del pulsante del mouse 
bit 6 (INPUT-BIT) impostato a 1 se dall'ultima chiamata di interrupt 
e' avvenuto un cambiamento di stato del dispositivo di input 

MOUSE-BIT = X00100080 

INPUT-BIT = X01008000 

Variabili opzionali del mouse 

maxMouseSpeed byte Questa variabile viene utilizzata per controllare la massima 

velocita' di spostamento del mouse sullo schermo quando 
il dispositivo di input e' il joystick. Non viene impiegata 
dai driver per la tavoletta grafica e per il mouse proporzionale. 

Il suo valore ottimale dipende da come il driver di input 
determina velocita' e posizione correnti. Per il joystick 
il range e' (0 - 127). Il valore di default e'i 

MflX-VELOCITY = 127 

Questa e' la costante per la velocita' massima di default 
da memorizzare in maxMouseSpeed 

fflinMouseSpeed byte Questa variabile e' utilizzata per controllare la minima 

velocita' di spostamento del mouse sullo schermo, quando 
il dispositivo di input e' il joystick. Non viene impiegata 
dai driver per la tavoletta grafica e per il mouse proporzionale. 

Il suo valore ottimale dipende da come il driver di input determina 
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•ouseflccel 


inputyector 


inputData 


velocita' e posizione correnti. Per il joystick 
il ranye e' (0 - 127). Il valore di default e'; 

«IN-VELOCITY = 30 

Questa costante viene aenorizzata nella variabile minHouseSpeed. 
Una velocita' liniaa Minore di questo valore può' venire 
iapostata per regolazioni aolto precise della posizione del nouse 
sullo scherno, na e' sconsigliabile per le operazioni nomali 

byte Questo byte controlla la rapidità' con la quale il nouse 

raggiunge la velocita' nassina consentita, quando il dispositivo 
di input e' il Joystick. Nel caso di una tavoletta grafica, 
questa variabile potrebbe essere utilizzata cone rapporto 
di conversione fra lo spostanento della penna sulla tavoletta 
e il corrispondente spostanento sullo scherno, flttualnente 
questa variabile viene inpiegata solo dal driver del Joystick. 

Per il Joystick il range e' (0 - 255). Il valore di default e': 

«OUSE-flCCEL= 127 

word Questo vettore contiene l'indirizzo della routine 

dell'applicazione, eseguita da MainLoop, che gestisce 
i paranetri speciali nel caso di dispositivi di input particolari 
0 a conunicazione diretta. L'esigenza di uno spazio 
supplenentare per i paranetri di gestione del particolare 
dispositivo di input, nasce dalla possibilità' che alcuni driver 
generino un nunero Maggiore di infornazioni, oltre 
alle coordinate x e y del nouse, e che alcune applicazioni 
richiedano questi paranetri addizionali. Se la routine 
UpdateNouse di un particolare driver e' piu' elaborata 
e pernette la gestione di informazioni opzionali, deve 
nenorizzarle nell'array da quattro byte a inputData, e deve 
inpostare a 1 il bit INPUT-BIT nella variabile pressFlag. 

Quando il ciclo NainLoop di GEOS si accorge che questo bit 
e' inpostato a 1, chiana la routine il cui indirizzo e' nenorizzato 
in inputVector 

4 byte Questa piccola area di nenoria può' essere impiegata 
per nenorizzare paranetri addizionali per la gestione 
di un particolare dispositivo di input. Per il Joystick: 
inputData: bit 0 - 7 direzioni del Joystick: 0- destra 

1« avanti e destra 
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2“ avanti 
3= avanti e 
4= sinistra 
5“ indietro 
6= indietro 
7= indietro 
-1= joystick 


sinistra 

e sinistra 

e destra 
centrato 


inputData + 1: velocita' del nouse corrente 


n mouse visto dall’applicazione 

Finora abbiamo discusso l’argomento dal punto di vista di un programmatore che 
vuole realizzare un driver di input. L’altra faccia della medaglia riguarda l’interazione 
fra l’applicazione e il driver di input. La gestione del mouse effettuata da GEOS è già 
stata discussa: ogni volta che l’utente preme il pulsante del mouse, GEOS controlla se 
il mouse si trova su im’icona, su un menu o su un’area dello schermo non 
convenzionale, e chiama le appropriate routine di gestione dell’evento. 

Per ottenere questo tipo di gestione del mouse, si deve eseguire la routine 
StartMouseMode. Dal momento che è deskTop a chiamare questa routine, le 
applicazioni non dovrebbero aver bisogno di eseguirla. Per disattivare le funzioni del 
mouse si deve chiamare la routine ClearMouseMode. L’effetto è che un bit della 
variabile mouseOn viene azzerato, lo aprite per il mouse viene disattivato (i dati dello 
aprite non sono più direttamente accessibili per essere ^visualizzati; questo stato è 
molto importante per l’interfaccia RS-232, per gli accessi al disco e per tutte le routine 
che hanno tempi precisi da rispettare) e UpdateMouse non viene più eseguita durante 
i cicli di interrupt. Questa è la ragione per cui il mouse appare e scompare durante gli 
accessi al disco: ClearMouseMode viene eseguita dal codice di gestione del turbo. Per 
ripristinare il funzionamento del mouse dopo aver chiamato ClearMouseMode, si deve 
eseguire la routine StartMouseMode. 

Per disattivare temporaneamente il disegno del mouse sullo schermo, lasciando 
però che le sue vmiabili di gestione continuino a venire aggiornate, si deve chieunare 
la routine MouseOff. La routine UpdateMouse nel driver di input continua a essere 
eseguita, e solo lo sprite 0 è temporaneamente disattivato. Per riabilitcue la 
visualizzazione del mouse sullo schermo è sufficiente eseguire la routine MouseUp, la 
quale riabilita la visualizzazione del mouse alla successiva chiamata di interrupt. 
Durante la temporanea cancellazione del mouse dallo schermo, l’utente pùò continuare 
a muoverlo anche se non riesce a vederne gli spostamenti. Chiamando MouseUp il 
mouse riappare nella nuova posizione. 





Funzione: Abilita il funzionamento del nnouse. Questa routine chiama anche InitMouse. 


Indirizzo: $C14E 

Parametri: C se è impostato a 1, la routine aggiorna la posizione del mouse con 

le coordinate ricevute, e azzera la velocità 
ri 1 nuova coordinata x, abilitata solo se il carry è impostato a 1 
(0 - 319) 

y nuova coordinata y, abilitata solo se il carry è impostato a l 
(0 -199) 

Restituisce: Niente 

Distrugge: a, x, y, rO - r15 

Sinossi: StartMouseMode attiva il funzionamento del mouse. Viene abilitato il vettore 

mouseVector. Le variabili globali mouseLeft, mouseRight, mouseTop, e 
mouseBottom devono essere già state predisposte. StartMouseMode viene 
eseguita di norma dalla routine d’inizializzazione deH'applicazione. 

Se il carry è impostato a 1, le coordinate della posizione desiderata del 
mouse, passate attraverso rii e y, vengono memorizzate nelle variabili 
mouseXPos e mouseYPos, e la routine SlowMouse viene eseguita per ridurre 
a zero la velocità del mouse. 
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ClearMouseMode 


Funzione: Questa routine è complementare a StartMouseMode. Ha la funzione di 

disattivare completamente la gestione del mouse e quindi la sua 
visualizzazione sullo schermo. 


Indirizzo: $C19C 

Parametri: Nessuno 


Restituisce: mouseOn azzerata 


Sinossi: ClearMouseMode disabilita completamente la gestione del mouse da parte 

del Kernel di GEOS. Lo aprite sullo schermo viene cancellato tramite la 
routine DisableSprite, e la variabile mouseOn viene azzerata. Per riattivare il 
controllo e la visualizzazione del mouse si deve mandare in esecuzbne la 
routine StartMouseMode. 






MouseOff 

Funzione: Disabilita temporaneamente la visualizzazione del mouse sullo schermo. 


Indirizzo: $C18D 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, x, y, r3L 

Sinossi: Disattiva la visualizzazione del mouse sullo schermo. Tutte le variabili di 

gestione del mouse continuano a essere aggiornate. Si può cancellare 
provvisoriamente il mouse dallo schermo chiamando MouseOff, e successi¬ 
vamente farlo riapparire chiamando MouseUp. 






Funzione: Visualizza il mouse dopo una chiamata a MouseOff. 

Indirizzo: $C18A 

Parametri: Nessuno 

Restituisce: Niente 
Distrugge: a 

Sinossi: Riabilita la visualizzazione dei mouse dopo che è stata chiamata la routine 

MouseOff e imposta a 1 un flag per indicare a GEOS che alla prossima 
chiamata di interrupt deve ridfeegnare anche il cursore visibile (se prima era 
abilitato). Si può cancellare temporaneamente il mouse dallo schermo 
chiamando MouseOff, e successivamente farlo riapparire chiamando 
MouseUp. 
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Controlli addizionali del mouse 

GEOS permette alle applicazioni di limitare i movimenti del mouse a una particolare 
zona dello schermo. Il Kernel di GEOS costringe il mouse a non uscire dal rettangolo 
definito da due variabili word (mouseLeft e mouseRight) e da due variadìili byte 
(mouseTop e mouseBottom). Il driver di input non ha bisogno di conoscere i valori di 
queste variabili, dal momento che si limita ad aggiornare la posizione del mouse, 
memorizzando le nuove coordinate nelle variabili mouseXPos e mouseYPos. Quando 
il Kernel di GEOS legge i valori di queste due variabili, prima di portare realmente il 
mouse nella nuova posizione controlla che non corrisponda a un punto esterno alla 
regione delimitata, e se è necessario sposta il mouse sul bordo del rettangolo. In questo 
caso il Kernel di GEOS chiama la routine puntata dal vettore mouseFaultVec. 
Inizialmente questo vettore è impostato a 0 dal Kernel. L’applicazione, per esempio, 
può memorizzare nel vettore mouseFaultVec l’indirizzo di una routine interna in grado 
di effettuare lo scroll di un documento all’interno di una finestra. Per rilevare quale 
spostamento del mouse ha causato l’impiego del vettore mouseFaultVec, l’applicazio¬ 
ne può accedere alla variabile faultData, i cui possibili valori sono riportati in 
appendice. 

Nel Kernel di GEOS è prevista anche una routine in grado di controllare se il mouse 
si trova all’interno di una particolare regione dello schermo. Questa routine è utile 
soprattutto se l’applicazione deve attribuire un significato particolare alla pressione 
del pulsante aU’interno di una regione predefinita dello schermo, e questa regione non 
è controllata direttamente dal Kernel. Si tratta della routine IsMseInRegion, e i 
parametri che richiede sono le coordinate dei lati della regione da controllare. 

C’è infine una coppia di variabili destinate alla gestione del mouse: mousePicData 
(contiene 63 byte che definiscono il disegno del mouse sullo schermo) e mouseVector 
(contiene l’indirizzo di una routine che MainLoop chiama a ogni ciclo per gestire il 
mouse). Se il bit MOUSEON-BIT della variabile mouseOn è impostato a 1, ogni volta 
che il driver di input segnala la pressione del pulsante, viene eseguita la routine 
puntata dal vettore mouseVector. È decisamente improbabile che il programmatore 
ritenga necessario intervenire sul vettore mouseVector cambiandone il contenuto, 
perché così disabiliterebbe anche la gestione di icone e menu da parte di GEOS. Di 
solito, per aggiungere funzioni alla gestione del mouse i programmatori intervengono 
sul vettore otherPressVec. 

La variabile mouseOn contiene anche alcuni bit per attivare e disattivare la gestione 
dei menu e delle icone. Sfortunatamente, quando GEOS chiama la routine di gestione 
dei menu, questa imposta a 1 anche il bit che attiva la gestione delle icone, senza 
controllare se l’applicazione le aveva precedentemente definite. Per questo motivo è 
conveniente che ogni applicazione definisca almeno un’icona fittizia, per quanto non 
ne abbia effettivo bisogno. 

Queste variabili e le costanti per impostarle sono descritte dopo la presentazione 
della routine IsMseInRegion. 





Funzione: Controlla se il mouse si trova all’Interno di una particolare regione delio 

schermo. 


Indirizzo: $C263 

Parametri: r2L coordinata y del iato superiore delia regione (0-199) 

r2H coordinata y del lato inferiore della regione (0-199) 
r3 coordinata x del lato sinistro della regione (0 - 319) 

r4 coordinata x dei lato destro della regione (0 - 319) 

Restituisce: a TRUE (-1 ) se il mouse è nella regione, FALSE (0) se è esterno alla 

regione 

Distrugge: Niente 

Sinossi: IsMseInRegion controlla se le coordinate x e y del mouse rappresentano un 

punto dello schermo interno alla regione specificata. Se questo accade la 
routine restituisce lo stato TRUE in a, altrimenti lo stato FALSE. 
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Le variabili di gestione del mouse per le applicazioni 

Le seguenti variabili sono impiegate dal modulo di gestione del mouse, presente nel 
Kernel di GEOS, e sono disponibili per le applicazioni. 


mouseOn byte 


bit 7 
bit 6 
bit 5 


Questa variabile contiene alcuni flag che determinano 

lo stato del mouse. Inoltre contiene alcuni bit impiegati 

nella gestione dei menu e delle icone 

Se e' impostato a 1, il mouse e' abilitato 

Se la gestione dei menu e' attivata, e' impostato a 1 

Se la gestione delle icone e' attivata, e' impostato a 1 


SET-MSE-ON = XI0000000 
SET-MENUON = X01000000 
SET-ICONSON = X00100000 


bit impostato a 1 in 
bit impostato a 1 in 
bit impostato a 1 in 
nel Kernel imposta a 


mouseOn per abilitare 
mouseOn per abilitare 
mouseOn per abilitare 
1 questo bit quando s 


il mouse 
i menu 

le icone (un bug 
abilitano i menu) 


mouseLef t 

word 

il 

(0 

mouse non 

- 319) 

può 

roouseRight 

word’ 

il 

(0 

mouse non 

- 319) 

può 

mouseTop 

byte 

il 

(0 

mouse non 

- 199) 

può 

mouseBottom 

byte 

il 

(0 

mouse non 

- 199) 

può 


spostarsi piu' a sinistra di questa posizione 
spostarsi piu' a destra di questa posizione 
spostarsi piu' in aito di questa posizione 
spostarsi piu' in basso di questa posizione 


mousePicData 63 byte Dati per il disegno dello sprite che visualizza il mouse. 

11 Kernel di GEOS ne esegue una copia nell'area che contiene 
i dati della figura corrente del mouse 

mouseVector word Vettore che punta la routine chiamata dal Kernel di GEOS quando 

il pulsante del mouse viene premuto 

mouseFaultVec word Vettore che punta la routine chiamata dal Kernel di GEOS 

quando il mouse tenta di uscire dalla regione specificata. 
L'eventuale routine associata può' accedere alla variabile 
faultData per conoscere la causa che ha prodotto la propria 
esecuzione. Se il vettore e' azzerato, GEOS non permette 
al mouse di uscire dai confini stabiliti. Consultare 
il capitolo 21 per maggiori informazioni sul vettore 
mouseFaultVec 
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Joystick 

Questo file contiene il driver di input del joystick. 


U - 

Routine eseguibili: o-initMouse 

ou^iowMouse 

o-UpdateMouse 


99 


.include geosMacros 
.include geosConstants 
.include geostlemorgllap 
.include geosRoutines 


.psect $FD84 ;il File Header e' assemblato a IFD84 se viene impiegato il programma 

jBasic PRGTOGEOS per trasformare un programma PRG in uno in formato GEOS 


U - 

Blocco File Header del driver del joystick 


99 


JogHdr i 

jl primi quattro bgte del File Header sono impostati dal programma 
;di conversione PRGTOGEOS 

.byte (63|*80) ;64 byte per definire il disegno dell'icona 

.byte Xllllllll/411111111,pulluli 

. byte '/A0000^00,'/M0(l0^00, !i 00000001 

.byte V. 11000000 , 1001111 , ^11110001 

.byte X10100011,X00110000/400001801 
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.byte ‘/Amim.yMmm.mmmi 

.byte */!ie0e8eee,%eii000ie,%0ieeeiei 

.byte '^100e0000/'(ie0i 1100. ^00100101 

.byte ^10000001.^01101100.;!08100101 

.byte ^10000010^11100100,200011001 

.byte 210000100,211011010,200000001 

.byte 210001000,200111010,200008001 

.byte 210010000,200110110,200000001 

.byte 210100000,200001100,211111001 

.byte 210100000,200011000,210000101 

.byte 210110000,200110000,210000101 

.byte 210011000,201100000,211111001 

.byte 210001100,211000000,210000001 

.byte 210000111,210000000,210000001 

.byte 210000011,200000000,210000001 

.byte 210000000,200000000,200000001 

.byte 211111111,211111111,211111111 

.byte $80|USER 

.byte INPUT-OEVICE 

.byte SE6UENTIRL 

.word HOUSE-BflSE 

.word EndJoystick 

.word 0 

.byte “Input Drvr VI.1",0,8,0,8 

.byte "Bave & Mike",0,0,0,0,0,0,0,0,0 

.byte 0,0,0,0,0,0,0,0,0,0 

.byte 0,0,0,0,0,0,0,0,0,0 

.byte 0,0,0,0,0,0,0,0,0,0 

.byte 0,0,0,0,0,0,0,8,0,0 

.byte 0,0,0 

.byte 0 

.block 95 


jtipo Commodore associato ai file GEOS 
;tipo GEOS associato al file 
;file a struttura se<iuenziale 
;indirizzo d'inizio del file 
jindirizzo di fine del file (-1) 
jnon usato attualnente (indirizzo inizio 
;esecuzione) 

jl6 byte nome del file + 4 zeri 

;16 byte nome autore + 4 zeri 

jl6 byte nome applicazione parente + 4 zeri 

l2ì byte liberi per le applicazioni 


; inizio del testo opzionale associato 
;al file, zero per nessun testo 
jspazio disponibile per il testo opzionale 
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U- 

Tavola di salto alle routine del driver per il mouse 


-99 

.psect nOUSE-BflSE )$FE80 

} 

; Tavola di salto del driver di input 


InitMouse: 

Jmp 

o-lnitMouse 

jentry #0 

SlowMouse: 

Jmp 

o-SlouMouse 

jentry #1 

Updatellouse: 

jmp 

o-UpdateMouse 

jentry #2 


Variabili globali: 

Queste variabili sono allocate nell'area a inputData prevista 

per contenere variabili opzionali di gestione del dispositivo di input 


«souseDirection = inputData jdirezione corrente del mouse 

mouseSpeed = inputData + 1 jvelocita' corrente del mouse 

J 

; Variabili locali: 


fracXMouse: 

fracYMouse: 

fracSpeedMouse: 

velXMouse: 

velYMouse: 

currentMouse: 

curJoyStatus: 

lastKeyRead: 


.byte 0 ;frazione della posizione del mouse 

.byte 0 ;frazione della posizione dei mouse 

.byte 0 ;frazione della corrente velocita' del mouse 

.byte 0 jcomponente x di currentSpeed 

.byte 0 ;componente y di currentSpeed 

.byte 0 ;stato corrente del pulsante del mouse 

.byte 0 jstato corrente del joystick 

.byte 0 jvalore in input dalla porta del Joystick 
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InitMouse 


Chiamata da: Kernel di GEOS o applicazione, durante c^ni fase d’inizializ^iQne 
Parametri: Nessuno 

Restituisce: Niente 
Distrugge: a, x, y, rO - r15 

Sinossi: Questa routine iniziaJizza il mouse e lo posiziona nell’angolo superiore sinistro 

dello schermo. 


o-InitHouse: 


Jsr 

o-SlouMouse 

^esegue Ida #6, sta mouseSpeed 

sta 

fracSpeadllousa 


sta 

nouse){Pos 


sta 

mouseXPos + 1 


sta 

laouseYPos 


Ida 

#-l 

jnessuna direzione 

sta 

MouseDirection 


j«P 

CottputeHouseVels 

jnemorizza la corrente velocita 
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SlowMouse 


Chiamata da: Kernel di GEOS quando apre un menu 

Parametri: Nessuno 

Restituisce: a azzerato 

Distrugge: x, y, r1 - r13 

Sinossi: Questa routine azzera la velocità del mouse. 


o-SlouMousei LoadB iriouseSpeed, 0 ; azzera la velocita' del mouse 
SM-rtsi rts 






Chiamata da: I codici di intenrupt 
Parametri: Nessuno 


Restituisce: mouseXPos e mouseYPos aggiornati 
Distrugge: a, x, y, rO - r15 

Sinossi: Questa routine viene eseguita a ogni chiamata di intenrupt per aggiornare la 

posizione del mouse sullo schermo. Legge la porta del joystick e registra i 
nuovi valori della velocità. Sulla base di queste informazioni, la routine calcola 
le coordinate della nuova posizione dei mouse. Non muove direttamente il 
mouse, ma ne aggiorna le coordinate per individuarne la nuova posizione. 
È compito del Kernel di GEOS stabilire se visualizzare il mouse nella nuova 
posizione. 


o-UpdateMousei jsr C64Joystick ; legge la porta del joystick e ne aggiorna 

; la velocita' 

bbrf MOUSEON-BIT, mouseOn, Sh-rts jguesta macro istruzione cede 

jil controllo a SM-rts se il mouse 
;e' disabilitato, senza compiere 
;alcun aggiornamento 

Jsr UpdateMouseVels ; registra la velocita' del mouse calcolando 

;anche l'accelerazione 

Jsr UpdateMouseX jregistra la coordinata x del mouse e prosegue, 

jal ritorno dalla subroutine, in UpdateMouse'i' 
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UpdateMouseY 


Chiamata da: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


cx-UpdateMouse 

mouseYPos coordinata y corrente del mouse 

mouseYPos coordinata y aggiornata 

a, X, y, r1H 

Aggiorna la posizione y del mouse valutandola per mezzo della velocità 
corrente. 


UpdateMouseY; 


1011 


20$ I 


Idy 

«0 

jassume che la velocita' sia positiva 

Ida 

velYMouse 

; legge la velocita' verticale corrente 

bpl 

10$ 

;se positiva y = 0 

dey 


;se negativa y = -1 ($FF) 

sty 

rlH 

;itieiìfiorizza il byte alto 

asl 

a 

jslitta a sinistra tre volte 

rol 

rlH 


asl 

a 


rol 

rlH 


asl 

a 


rol 

rlH 


add 

fracYMouse 

jsorania l'incremento della coordinata 

sta 

fracYMouse 

; memorizza il nuovo incremento 

Ida 

rlH 

jpreleva il byte alto della velocita' 

adc 

ntouseYPos 

jsomma la precedente coordinata 

sta 

mouseVPos 


rts 









Chiamata da: o-UpdateMouse 

Parametri: mouseSpeed velocità corrente dei mouse 

velXMouse, velYMouse componenti della velocità corrente 

Restituisce: mouseSpeed, velXMouse, velYMouse aggiornate 

Distrugge: a, x, y, rO - r2 

Sinossi: Aggiorna la velocità del mouse tenendo conto dell’accelerazione. 


UpdatellouseVels: 




Idx 

«ouseDireetion 

; legge la direzione del nouse 


bmi 

20$ 

jse il joystiek e' eentrato effettua i 

1 branch 

Ida 

saxllouseSpeed 

jeonfronta eon la nassina veloeita' 


cnp 

iouseSpeed 



bit 

15$ 

;se e' nassina non eanbiarla 


Ida 

ttouseReeel 

!addiziona alla veloeita' l'inerenento 


add 

fraeSpeedHouse 

;diveloeita' 


Sta 

fraeSpeednouse 



bcc 

30$ 



ine 

BOUseSpeed 

jse neeessario inerenenta la veloeita' 

del nouse 

bra 

30$ 



15$! 




sta 

nouseSpeed 



20$! 




Ida 

BinHouseSpeed 

;preleva la velocita', che 


cip 

BOuseSpeed 

;non può' diventare neno del ninino 


bge 

25$ 

;se e' ninore del ninino, allora “branch" (salta) 

Ida 

fraeSpeedHouse 

jsottrae dalla velocita' l'inerenento 


sub 

nouseflceel 



sta 

fraeSpeedHouse 



bes 

30$ 



dee 

BOuseSpeed 

jse necessario dininuisce la velocita' 

del nouse 

bra 

30$ 
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25ti 


30t I 


sta mouseSpeed 

jmp ComputeMouseyels ;adesso i parametri sono sufficienti 

;per determinare la nuova velocita' 

; verticale e orizzontale 





Funzione: Routine interna: calcola la velocità del mouse tramite la direzione dei joystick. 

Chiamata da: Viene chiamata internamente 


Parameli: mouseDirection direzione del joystick 

mouseSpeed velocità corrente del mouse 

Restituisce: velXMouse, velYMouse aggiornati secondo la direzione assunta dal joystick 

Distrugge: a, x, y, rO - r2 

Sinossi: Questa routine calcola la velocità verticale e la velocità orizzontale del 

mouse, sulla base della direzione assunta dal Joystick. 


ConiputeMouseVelsi 



Idx 

mouseDirection 


bai 

10$ 

;se il joystick e' rilasciato, azzera 
;le velocita' 

HoveB 

mouseSpeed, r0L 

;passa i parametri 

Jsr 

SineCosine 


MoveB 

rlH, velXMouse 


MoveB 

r2H, velYMouse 


rts 



101; 



Ida 

#0 

;se il Joystick e' rilasciato 

sta 

velXMouse 

;azzera la velocita' orizzontale 

sta 

velYMouse 

^azzera la velocita' verticale 

rts 
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UpdateMouseX 


Funzione: 

Chiamata da: 

Parametri: 

Restituisce: 

Distrugge: 

Funzione: 


Routine interna: aggiorna la coordinata x del mouse basandosi sulla sua 
velocità. 

o-UpdateMouse 

mouseXPos coordinata x del mouse 

mouseXPos aggiornata 

a, X, y, r11, r12L 

Questa routine aggiorna la coordinata x del mcxjse basandosi sulla sua 
velocità orizzontale. 


UpdatetlouseX: 


Idy 

#$FF 

jassuise un valore negativo 

Ida 

veixnouse 


bui 

16$ 

;se negativo salta 

iny 


jaltrinenti il segno diventa positivo 

sty 

rllH 


sty 

rl2L 


asl 

a 

jinoltiplica per 8 per ottenere la velocita 
;peri)ianente elevata alla terza 

rol 

rllH 


asl 

a 


rol 

rllH 


asl 

a 


rol 

rllH 

jsoinitta la velocita' allo spostamento 

add 

fracXMouse 

jsomna lo spostamento 

sta 

fracXHouse 

.'memorizza lo spostamento 

Ida 

rllH 

;preleva il byte basso della velocita' 
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adc 

mouseXPos 

; somma il byte basso della velocita' 

sta 

mouseXPos 

;e memorizza 

Ida 

rl2L 

;si utilizza matematica in tripla precisione 

adc 

mouseXPos+1 

;somma il byte alto della coordinata x intera 

sta 

mouseXPos+l 

.irli contiene la nuova coordinata x 





Funzione: Routine interna: legge la porta del joystick per accedere alle variabili di 

posizione e di movimento del mouse. 

Chiamata da: o-UpdateMouse 

Parametri: Nessuno 

Restituisce: Niente 

Altera: lastKeyRead contiene l’ultima lettura del joystick 

curJoyStatus impostato per contenere la nuova direzione del joystick 
pressFlag MOUSE-BIT impostato a 1 se il pulsante è premuto 
JOY-BIT impostato a 1 se la direzione del joystick è ' 
variata 

mouseDirection nuova direzione del joystick, 
mouseData nuovo stato del pulsante del mouse, se ci sono state 
variazioni 

Distrugge: a, x, y 


C64Joysticki 

LoadB 

cialpra, 

jsi accerta di leggere valori dal Joystick 


Ida 

cialprb 

jpreleva il dato del Joystick fl (porta 1) 


eor 

#$FF 

;dato complementare per logica positiva 


cmp 

lastKeyRead 

;dev'essere lo stesso due volte 


S13 

lastKeyRead 

imemorizza il valore per il confronto 


bn$ 

20t 

;se non e' uguale, esce 


and 

#$0F 

jisola i bit del Joystick 


CfflP 

curJoyStatus 

('confronta con la posizione corrente 


bs'i 

10$ 

jse non c'e' nessuna differenza, branch 


S13 

curJoyStatus 

; memorizza il nuovo valore 


tay 
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10$l 


20 $ ! 


Ida directioriTable,. y jpreleva dalla tavola il valore da passare 
sta KiouseDirection 

smbf INPUT-BIT, pressFlag .isegnala il cambiamento avvenuto 

.inel dispositivo di input 

jsr ComputeMouseVels 

Ida lastKeyRead jpreleva il dato per la pressione 

and #:';00010000 j isola il bit del pulsante 

cmp currentMouse .:e lo confronta con il valore corrente 

beq 20$ jse non c'e' nessuna differenza, branch 

sta currentMouse ;altrimenti imposta il nuovo stato del pulsante 

asl a ,ie lo trasporta nel bit 7 

asl a 

asl a 

eor #$10000000 jvalore di complemento per passare 

.:in logica positiva 

sta mouseOata 

smbf MOUSE-BIT, pressFlag ;segnala il cambiamento intervenuto 

.1 nel lo stato del pulsante 

rts 


directionTableI 

.byte -1 )se non e‘ selezionata alcuna direzione, passa a=-l 

.byte 2 .ivedere la conversione hardware descritta all'inizio 

.byte 6 ;di questo modulo per comprendere 

.byte $FF .ila conversione della direzione qui effettuata 

.byte 4 inotare che $FF corrisponde a uno stato non valido, 

.byte 3 jquesto stato non dovrebbe verificarsi mai, a meno 

.byte 5 ;che il joystick non sia rotto 

.byte $FF 

.byte 0 

.byte 1 

.byte 7 

.byte $FF 

.byte $FF 

.byte $FF 

.byte $FF 

.byte $FF 
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SineCosine 

Funzione: 

Routine interna: SineCosine genera seno e coseno di 16 possibili direzioni 
e moltiplica questi valori per un parametro. 

Chiamata da: 

ComputMouseVels 


Parametri: 

X, mouseDirection 

direzione (0 a 15) 


rOL 

parametro della velocità 

Restituisce: 

rIH 

velocità X 


r2H 

velocità y 

Distrugge: 

a, X, y, rO, r6 - r8 



SineCosine: 

Ida 

cosineTable, x 

j s a 1V a i ] 

l valore del coseno 


£ 13 

rlL 




Ida 

sineTable, x 

jsalva il 

l valore del seno 


sta 

r2L 




Ida 

sineCosineTablej 

X ; preleva 

il segno 


pha 





Idx 

#rlL 

;calcola 

la velocita' orizzontale 


Idy 

#r0L 




jsr 

BBMult 




Idx 

#r2L 

;calcola 

la velocita' verticale 


Jsr 

BBMult 

jy punta 

già' a r0L 


pia 





pha 





bpl 

10$ 

;se la velocita' orizzontale e' positiva, branchi 


Negateli ri 



10$; 

pia 





and 

*1:1000000 




beq 

20$ 

;se la velocita' verticale e' positiva, branch 
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20 $; 


cosineTable; 


sineTablei 


sineCosineTable: 


NegateH r2 
rts 


.byte 255 
.byte 181 


.byte 0 
.byte 181 
.byte 255 
.byte 181 
.byte 0 
.byte 181 
.byte 255 
.byte 181 


jdireziene 0 - 8 gradi dell'angolo 
^direzione 2 - 45 gradi dell'angolo 
;nota: la tavola dei coseni si sovrappone 
;a quella dei Seni che segue 

^direzione 8 * 8 gradi dell'angolo 
jdirezione 2 * 45 gradi dell'angolo 
;direzione 4 - 98 gradi dell'angolo 
; di razione 6 ■ 135 gradi dell'angolo 
jdirezione 8 - 188 gradi dell'angolo 
jdirezione 10 - -135 gradi dell'angolo 
jdirezione 12 - -98 gradi dell'angolo 
jdirezione 14 ■ -45 gradi dell'angolo 


.byte POSITIVE 
.byte POSITIVE 
.byte POSITIVE 
.byte NEG8TIVE 
.byte NEGATIVE 
.byte NEGATIVE 
.byte POSITIVE 
.byte POSITIVE 


(POSITIVE 

1) 

jdirezione 

(NEGATIVE 

1) 

jdirezione 

(NEGATIVE 

1) 

jdirezione 

(NEGATIVE 

1) 

jdirezione 

(POSITIVE 

1) 

Jdirezione 

(POSITIVE 

1) 

jdirezione 

(POSITIVE 

1) 

jdirezione 

(POSITIVE 

1) 

jdirezione 


0 - 0 gradi dell'angolo 
2 - 45 gradi dell'angolo 
4 - 98 gradi dell'angolo 
6 * 135 gradi dell'angolo 
8 - 180 gradi dell'angolo 
10 - -135 gradi dell'angolo 
12 - -90 gradi dell'angolo 
14 - -45 gradi dell'angolo 






8 LA GESTIONE 
DEGLI SPRITE 


Il Kernel di GEOS prevede una semplice interfaccia per la gestione degli sprite 
hardvyrare del C-64. Le routine di cui è composta controllano gli sprite scrivendo negli 
appositi registri presenti nel processore VIC e negli spazi di memoria in cui il VIC legge 
i disegni degli sprite. Il lettore dovrebbe avere familiarità con la gestione di base degli 
sprite messa a disposizione dal C-64. Una delle scelte fatte durante la creazione di 
GEOS (per quanto riguarda gli sprite), è stata d’installare esclusivamente le funzioni 
di gestione fondamentali. Applicazioni che richiedono un uso elaborato degli sprite, 
come i giochi, non hanno un particolare bisogno di GEOS, mentre le applicazioni che 
riguardano problemi commerciali o che trattano principalmente i testi troveranno 
utilissime le caratteristiche messe a disposizione da GEOS, e probabilmente non 
avranno bisogno di tecniche di gestione degli sprite troppo sofisticate. 

11 Kernel di GEOS prevede quattro routine per disegnare, cancellare e posizionare 
gli sprite: 

DrawSprite 

PosSprite 

EnablSprite 

DisablSprite 




Funziom: Disegna/rìdisegna uno aprite. 

Indirizzo: $C1C6 


Paramotri: r3L numero dello aprite (0 - 7) 

r4 puntatore ai dati che compongono il diaegno dello aprite 

Rastituisca: 64 byte copiati dall’area puntata da r4 all’area che GEOS dedica allo aprite 
il cui numero è apedficato da rSL (viene copiato un byte extra, aebbene uno 
aprite aia compoato da 63 byte) 

Distrugga: a, y, r5 

Sinossi: DrawSprite trasferiace i dati grafici dello aprite dall’area puntata da r4 all’area 

RAM che il proceaaore VIC utilizza per viaualizzare lo aprite il cui numero è 
paaaato in r3L. Lo aprite 0 viene utilizzato per il mouae, e lo aprite 1 per il 
curaore viaibile (la barra verticale). Queata routine provvede aolo a aoatituire 
la figura corrente dello aprite con un’altra, e quindi agiace anche ae lo aprite 
non è abilitato. 






Funzione: Posiziona uno sprite sullo schermo utilizzando le coordinate GEOS x e y (non 

le coordinate hardware del C-64). 

Indirizzo: $C1CF 


Parametri: r3L numero dello sprite (0 - 7) 

r4 coordinata x (0 - 319) 

r5L coordinata y (0 -199) 

Restituisce: r3L inalterato 

Distrugge: a, x, y, r6 

Sinossi: PosSprite converte le coordinate x e y che indicano la posizione dello 

sprite - in ambiente GEOS sono una word (0 - 319) per x e un byte (0-199) 
per y - nelle strane coordinate hardware tipiche del C-64. Le coordinate 
convertite sono memorizzate nei registri hardware di posizbne presenti nel 
Vie, i cui valori determinano la posizione dello sprite sullo schermo. 
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EnabISprite 


Funzione: 

Indirizzo: 

Parametri: 

Restituisce: 


Attiva la visualizzazione di uno aprite sullo schermo. 

$C1D2 

r3L numero dello aprite (0 - 7) 

Gli appositi registri del VIC aggiornati per visualizzare lo aprite. r3L non viene 
alterato 


Distrugge: a, x 

Sinossi: Aggiorna l’opportuno bit del registro mobenble del VIC per abilitare lo aprite 

il cui numero viene passato in r3L. 
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Funzione: Disabilita la visualizzazione di uno aprite. 

Indirizzo: $C1D5 

Parametri: r3L numero dello aprite (0 - 7) 

Restituisce: Gli appositi registri del VIC vengono aggiornati per disabilitare la 
visualizzazione dello sprite. r3L non viene alterato 

Distrugge: a, x 

Sinossi: Aggiorna i bit del registro mobenble del VIC, per disabilitare lo sprite il cui 

numero viene passato in r3L. 






9 1 PROCESSI 
TEMPORIZZATI 


GEOS è in grado di gestire i processi temporizzati. Un processo temporizzato, per il 
Kernel di GEOS, è una subroutine che dev’essere eseguita ogni volta che è stato 
effettuato un predefinito numero di chiamate di interrupt. InterruptMain imposta un 
flag quando, per un certo processo, il numero di interrupt incorsi corrisponde a quello 
assegnato al processo dall’applicazione. Il flag indica a MainLoop che deve eseguire 
il processo temporizzato associato. Il sistema può eseguirne molti simultaneamente (o 
meglio durante lo stesso ciclo di MainLoop). Per esempio, una parte dello schermo può 
essere destinata a un orologio, mentre un’altra è occupata dal testo che sta battendo 
l’utente e in una finestra un foglio elettronico ricalcola i valori di tutte le celle. I processi 
temporizzati si impiegano anche per costruire subroutine che reagiscono a una certa 
situazione operando le opportune scelte. Per esempio si potrebbe usarne uno per 
ceimbiare la figura del mouse da cursore visibile a freccia quando si muove da un testo 
su un’icona. 

Per la gestione dei processi temporizzati sono disponibili in GEOS: 

1) un modulo timer in InterruptMain per decrementare i contatori associati ai vari 
processi temporizzati 

2) un modulo di attivazione in MainLoop per eseguire i processi temporizzati 
quando i rispettivi timer lo segnalano 

3) l’applicazione deve provvedere a una tavola di definizione dei processi 
temporizzati, aU’interno della quale vengono memorizzati gli indirizzi delle 
routine di servizio associate a ogni processo definito. 

Quando il modulo di gestione dei processi viene inizializzato, a ogni processo è 
assegnato un timer e un flag (un byte). A ogni sessantesimo di secondo, il modulo 
timer presente in InterruptMain decrementa tutti i timer associati ai vari processi. 
Quando uno dei timer si azzera, InterruptMain imposta a 1 il bit di run presente nel 
flag di processo associato. Quando MainLoop, nel suo controllo periodico, trova il bit 
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di run di uno dei flag di processo abilitati impostato a 1, esegue la routine di servizio 
associata al processo. L’applicazione deve aver previsto una tavola di dati nella quale 
siano definiti gli indirizzi delle routine di servizio associate a ogni processo 
temporizzato, e il tempo che deve trascorrere fra un’esecuzione e la successiva. Ecco 
una tipica tavola di definizione dei processi; 


ProcessTablei 
.word ProcessRoutinel 

.word HI 

.word ProcessRoutine2 

.word N2 


{indirizzo della routine di servizio del processo 1 
{esegui ProcessRoutinel ogni NI chiamate di interrupt 
{indirizzo della routine di servizio del processo 2 
{esegui ProcessRoutine2 ogni N2 chiamate di interrupt 


Queste informazioni sono le sole di cui GEOS ha bisogno per gestire i processi 
temporizzati. 

I processi possono trovarsi in tre stati diversi: eseguibile, bloccato, congelato. Un 
processo eseguibile ha il timer associato che viene continuamente decrementato a 
ogni chiamata di interrupt, e quando questo si azzera viene normalmente eseguita la 
routine di servizio. Un processo bloccato ha il timer che continua a essere 
decrementato a ogni chiamata di interrupt, ma quando arriva a zero la routine di 
servizio del processo non viene eseguita. Un processo congelato ha il conteggio del suo 
timer momentaneamente interrotto. Anche in questo caso, la routine di servizio 
associata al processo non può essere eseguita. 

Vediamo come sfruttare le opportunità offerte da ciascuno dei tre stati in cui un 
processo può trovarsi. Il “congelamento" è molto utile quando due o più processi 
devono essere eseguiti in un certo ordine. Dovendo, per un motivo qualsiasi, 
interrompere lo svolgimento dei processi, si scoprirà che dopo aver disabilitato gli 
interrupt, congelato i processi e infine riabilitato gli interrupt, le relazioni fra i vari 
timer associati sono rimaste inalterate. 

Facciamo un altro esempio. Supponiamo di predisporre un processo che visualizza 
un orologio ogni secondo, ma che deve interrompere la visualizzazione in particolari 
periodi di tempo. Bloccando il processo, il relativo timer continua a essere 
decrementato, ma la routine associata non viene eseguita e quindi l’orologio non viene 
visualizzato per tutto il periodo desiderato. Purtroppo non viene eseguito nemmeno il 
cambiamento dell’ora, dunque l’orologio sarà in ritardo. 

Le applicazioni hanno anche la possibilità di intervenire sulla normale gestione dei 
processi. La routine EnableProcess manda forzatamente in esecuzione, al successivo 
ciclo di MainLoop, un particolare processo. Se questo è bloccato, o congelato, dopo 
l’esecuzione forzata rimarrà ancora bloccato o congelato. Con questa routine un 
processo può essere mandato in esecuzione in qualunque momento, e se è in stato di 
eseguibile, il suo timer inizia nuovamente a decrementarsi. 

Oltre alla gestione dei processi temporizzati, GEOS consente anche di “addormenta¬ 
re” una qualsiasi routine. Il concetto è molto semplice. Quando una routine usufruisce 
di questa opportunità, interrompe momentaneamente la sua esecuzione, e nel periodo 
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d’interruzione possono essere eseguiti altri codici. Quando l'intervallo prestabilito è 
terminato, la routine riprende l’esecuzione dal punto in cui era stata interrotta. Si noti 
che durante l’intervallo i contenuti dei registri possono essere variati. 

È sconsigliabile adottare una routine che utilizzi l’opportunità di “addormentarsi” e 
contemporaneamente abbia a che fare, attivamente o passivamente, con lo stato della 
macchina o con le varieibili globali, in quanto è difficile prevedere quale sarà la nuova 
configurazione al momento del “risveglio". Un’altra utile precauzione è quella di fare 
eseguire direttamente da MainLoop le routine che utilizzano l’opzione sleep, senza 
intermediazioni di altre routine di livello superiore. Vediamone il motivo. Quando una 
routine viene risvegliata, riprende l’esecuzione nel punto esatto in cui era stata 
interrotta, ma viene a trovarsi in un nuovo ambiente. Quando era stata originariamente 
addormentata, il modulo di gestione sleep aveva memorizzato l’indirizzo dell’istruzio¬ 
ne successiva alla jsr Sleep. Allo scadere dell’intervallo di tempo fissato, il modulo di 
gestione sleep esegue l’istruzione jsr all’indirizzo precedentemente salvato. La routine 
riprende quindi l’esecuzione (si risveglia) e si completa secondo il suo naturale 
decorso. Ma a questo punto, eseguendo l’istruzione rts che la termina, la routine non 
restituisce il controllo alla routine di livello superiore che l’aveva inizialmente 
chiamata, ma al modulo di gestione sleep presente in MainLoop. In generale solo le 
routine chiamate da MainLoop dovrebbero utilizzare l’opzione sleep, altrimenti c’è il 
rischio che riprendano la loro esecuzione in un ambiente totalmente diverso. Per 
concludere, è bene tener presente che anche avere una routine addormentata e nel 
frattempo addormentarne un’altra è sconsigliabile. Potrebbero crearsi dei cicli 
completamente indesiderati e difficili da analizzare. L’opzione sleep è utile per 
visualizzare messaggi sullo schermo che non alterano lo stato della macchina. Per 
esempio, supponiamo che una routine debba visueilizzare diversi messaggi sullo 
schermo, facendo in modo che ogni messaggio rimanga visualizzato per un certo 
tempo e l’utente riesca a leggerlo. Normalmente questa operazione si può realizzare 
con una routine che visualizza un messaggio dopo l’altro a intervalli generati da un 
loop interno di ritardo. Ma si tratta di una soluzione poco efficiente, in quanto il loop 
che crea l’intervallo fra un messaggio e l’altro occupa inutilmente il processore per 
tutta la durata del ritardo, non permettendogli (interrupt a parte) di compiere altre 
operazioni. Se invece la routine che risolve il problema adotta l’opzione sleep ogni volta 
che visualizza un messaggio, e imposta un tempo di sleep tale da permettere all’utente 
di leggere l’intero messaggio, il processore può effettuare altre operazioni durante la 
sua temporanea inattività, come ad esempio eseguire le istruzioni di MainLoop o altro. 
Quando la routine si risveglia, visualizza un altro messaggio e riprende a dormire in 
attesa di essere risvegliata nuovamente e così continua fino a quando non ha esaurito 
i messaggi da visualizzare. Ogni volta che si addormenta, il processore può dedicarsi 
ad altro. Quindi l’utente può per esempio scrivere un testo mentre sullo schermo, in 
un’opportuna finestra, continua ad apparire una serie di messaggi. 

Nessuna delle variabili di gestione dei processi è accessibile direttamente: possono 
essere manipolate solo attraverso le routine che ora descriveremo. 
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InitProcesses 


Funzione: Inizializza tutti i processi definiti, ma non li abilita. 

indirizzo: $C103 


Parametri: 

Restituisce: 

Distrugge: 


a numero di processi (1 - 20) 

lO puntatore alla tavola di definizione dei processi 

rO inalterato 

a, X, y 


Sinossi: InitProcesses copia dalla tavola di definizione gli indirizzi delle routine di 

servizio e gli intervalli di ripetizfone, e imposta nello stato di congelato ogni 
processo. Per abilitare un processo l’applicazione deve chiamare la routine 
RestartProcess. 

GEOS non è in grado di gestire più di 20 processi simultaneamente. 
Questa routine assegna a ogni processo una locazione che ne identifica lo 
stato. Nella versione 1.2 e 1.3 del Kernel queste locazioni sono disposte 
sequenzialmente a partire dalfindirizzo processFlags ($8719), e non 
possono essere più di 20. La prima locazione, processFlags + 0, è 
assegnata al processo 1, la seconda locazione, processFlags + 1, è 
assegnata al processo 2, e così via. Nelfappendice A sono riportate le 
costanti che individuano i possibili stati dei processi. L'applicazione non 
dovrebbe comunque avere necessità di accedere a processFlags, dal 
momento che il Kernel prevede tutte le routine necessarie alla gestione dei 
processi. 





I PROCESSI TEMPORIZZATI 


197 


RestartProcess 


Funzione: 

Indirizzo: 

Parametri: 

Restituisce: 

Distnigge: 

Sinossi: 


Sblocca e scongela un processo iniz^izzandone II timer. 

$C106 

X il numero del processo da attivarP/riattivare, 0 per il primo processo 
X inalterato 
a 

Abilita l’esecuzione di un processo a intervalli fissi predefirìiti. Per prima cosa 
la routine sblocca e scongela il processo in modo da renderlo eseguibile. 
Subito dopo il t^er viene aggiornato con il valore presente nella tavola di 
definizione e viene abilitata l’esecuzione dei processo. 






BlockProcess, UnblockProcess 


Funzione: Biocca (Block) e sblocca (Unbiock) l’esecuzione delia routine di servizio di 

un processo. 

Indirizzi: BlockProcess $C1(K) 

UnblockProcess $C10F 

Parametri: x numero del processo interessato al cambio di stato 

Restituisce: x inalterato 

Distrugge: a 

Sinossi: BlockProcess: imposta un flag per indicare che la routine di servizio del 

processo non dev’essere eseguita. Nonostante questo, il timer di processo 
continua a essere decrementato, e viene riaggiomato se si azzera. Perché 
la routine associata ai processo riprenda a essere eseguita con periodicità, 
bisogna che l’applicazione la sblocchi. 

UnblockProcess: imposta a 0 il flag in maniera che la routine di servizio del 
processo tomi a essere eseguita periodicamente. 






FreezeProcess, UnfreezeProcess 


Funzione: Congela (Freeze) e scongela (Unfreeze) il timer di un processo. 

Indirizzi: FreezeProcess $C112 

UnfreezeProcess $C115 

Parametri: x il numero del processo da congelare/scongelare 

Restituisce: x inalterato 

Distrugge: a 

Sinossi: FreezeProcess: disattiva il funzionamento del timer associato al processo 

indicato. In questo modo la routine di servizio non può essere eseguita e il 
timer si mantiene ai valore ai quale è stato congelato. 

UnfreezeProcess: riattiva il funzionamento del timer associato al processo 
indicato. In questo modo la routine di servizio toma a essere eseguita con 
periodicità. 





Funzione: Interrompe l’esecuzione della routine che ha eseguito l’istruzione jsr Sleep 

per un tempo determinato. 

Indirizzo: $C199 


Parametri: rO indica l’intervallo di tempo, in sessantesimi di secondo, per il quale la 

routine deve rimanere in stato di sleep 

Restituisce: Non definibile 

Distrugge: Non definibile 

Sinossi: Sleep salva l’indirizzo a cui cederà il controllo quando la routine sarà 

risvegliata, e forza l’esecuzione dell’istruzione rts, terminando così la routine 
nell’esatto punto dove avviene la chiamata jsr Sleep. Quindi se la routine 1 
chiama la routine 2 e quest’uttima esegue la routine Sleep, GEOS salva un 
puntatore che indica il punto esatto nella routine 2 dove riprenderà 
l’esecuzione, e forza un rts in modo che il controllo ritorni alla routine 1. 
Questa, ripreso il controllo, si compieta e ritorna a MainLoop. È a questo 
punto che MainLoop inizia a interagire con il modulo Sleep. Quando 
l’intervallo di sleep della routine 2 è terminato, GEOS cede il controllo 
all’indirizzo specificato dal puntatore precedentemente salvato, e la routine 
2 termina, a sua volta, la propria esecuzione. Ma quando passa all’istruzione 
rts, il controiio non viene ceduto alla routine 2 che l’aveva chiamata, ma ai 
modulo sleep presente in MainLoop che l’ha risvegliata. Questo è facilmente 
spiegabile. Quando la routine 2 si addormenta, il controllo viene ceduto alla 
routine 1 tramite l’istruzione rts. Routine 1 non può sapere se routine 2 le ha 
ceduto il controllo perché è stata forzata a farlo o perché la routine è stata 
realmente eseguita. Del resto la cosa le è indifferente, e riprende 
l’esecuzione. Dal momento che routine 2 è già ritornata a routine 1 una volta, 
non ha senso che lo rifaccia anche la seconda volta, quando termina 
“realmente” la propria esecuzione, e così il controllo viene ceduto al modulo 
sleep di MainLoop. Proprio per questo, è preferibile che una routine che al 
suo interno utilizza l’opzione sleep, sia stata originariamente chiamata da 
MainLoop; solo cosi, durante le successive chiamate a Sleep e aliatine della 
routine, il controllo viene ceduto alla routine che aveva fatto la prima 
chiamata, cioè MainLoop. 





I PROCESSI TEMPORIZZATI 


201 


Comunque anche una subroutine può contenere una chiamata a Sleep, purché si tenga 
conto delle differenze che intervengono in questo caso. Vediamone un esempio. 

Callin 9 Routine; 


codici 



jsr PrintLater 



codici 




rts 



PrintLaterì 

Ida 

#<N 

; passa il nunero N di interrupt di attesa 


sta 

r0L 



Ida 

#>N 



sta 

reH 



jsr 

Sleep 

;esegue Sleep restituendo il codice alla routine 
jche l'aveva chiaoata 


Codici per staapare <iualcosa in ritardo 


rts 

In questo caso, i codici di PrintLater successivi all’istruzione jsr Sleep (che non devono 
dipendere dallo stato della macchina e non devono alterarlo) vengono eseguiti per effettuare 
la stampa N chiamate di interrupt dopo la chiamata, e nei frattempo la routine che ha fatto 
la chiamata è libera di continuare. 





Funzione: Forza l’esecuzione di un processo, qualunque sia lo stato in cui si trova. 

Indirizzo: $C109 


Parametri: x numero del processo da eseguire 

Restituisce: x inalterato 

Distrugge: a 

Sinossi: Forza l’esecuzione del processo durante il successivo ciclo di MainLoop. Se 

il processo è bloccato e/o congelato, dopo la sua esecuzione forzata ritorna 
nello stato di bloccato e/o congelato. Se il processo è invece eseguibile, 
viene forzata la sua esecuzione e il timer toma al valore iniziale per riprendere 
a decrementarsi. 

EnableProcess è utile per essere sicuri che un processo viene eseguito 
almeno una volta. Il processo potrebbe essere già eseguibile o in uno degli 
altri due stati. Questa routine non cambia assolutamente niente nello stato 
del processo, e si limita a forzarne l’esecuzione una volta. 

EnableProcess è utile anche nel caso che l’applicazione preveda una 
propria routine di interrupt per gestire un dispositivo speciale, e che questa 
rilevi una condizione tale per cui nasca l’esigenza di sfruttare MainLoop per 
eseguire determinate routine. La distinzione importante, in questo caso, è 
che l’esigenza di eseguire particolari routine si scopre durante gli interrupt di 
sistema, ma le routine vengono eseguite durante MainLoop. 





J A LIBRERIA DI FUNZIONI 
I U MATEMATICHE 


Questo capitolo illustra le routine matematiche installate nel Kernel di GEOS. 
Questa libreria di routine prevede una varietà di utili funzioni matematiche, inclusa 
la moltiplicazione e la divisione fra word e byte. Eccone l’elenco. 

DShiftLeft Slitta una word a sinistra di n bit 

DShiftRight Slitta una word a destra di n bit 

BBMult Moltiplicazione fra due byte 

BMult Moltiplicazione fra un byte e una word 

DMult Moltiplicazione fra due word 

Ddiv Divisione fra due word 

DSdiv Divisione fra due word con segno 

Dabs Valore assoluto di una word 

Dnegate Negazione di una word complementata a due 

DDec Decrementazione di una word priva di segno 

GetRandom Genera una word casuale 




DShiftLeft - Scorrimento a sinistra in doppia 
precisione 


Funzione: Fa “slittare” i bit deiroperando di n posizioni a sinistra aH'intemo del byte. Il 

calcolo è: (operando * 2'’). 

Indirizzo: $C15D 

Parametri: x indirizzo dei registro in pagina zero (per esempio Idx #r1) 

y numero di posizioni di cui i bit deli’operando devono slittare 
a sinistra 

Restituisce: (x) il registro puntato da x viene slittato y volte a sinistra 
a, X inalterati 

Distrugge: y, $FF 

Sinossi: DShiftLeft è una routine che calcola in doppia precisione. Effettua lo 

slittamento a sinistra dei bit contenuti nello pseudoregistro da 16 bit puntato 
da X. Lo slittamento avviene per un numero y di posizioni. L’equazione per 
questo calcolo è: (operando * 2"). Tutti i fiag di stato contenuti nel PSW 
rimangono inalterati. 






DShìftRight - Scorrimento a destra in doppia precisione 


Funzione: Fa “slittare" i bit dell’operando di n posizioni a destra ali’intemo del byte. Il 

calcolo è: (operando / 2P). 

Indirizzo: $C262 

Parameli: x indirizzo del registro in pagina zero (per esempio Idx #r1) 

y numero di posizioni di cui i bit dell’operando devono slittare a destra 

Restituisce: (x) ii registro puntato da x viene slittato y voite a destra 
a, X inalterati 

Distrugge: y, $FF 

Sinossi: DShiftRight è una routine che calcola in doppia precisione. Effettua uno 

slittamento a destra dei bit contenuti nello pseudoregistro da 16 bit puntato 
da X. Lo slittamento avviene per un numero y di posizioni. L'equazione per 
questo calcolo è: (operando / 2'’). Tutti i flag di stato contenuti nel PSW 
rimangono inalterati. 





BBMult - MoKtpHcazione byte * byte 


Funzione: Moltiplica fra loro due operandi privi di segno e memorizza il prodotto nel 

registro in pagina 0 puntato da x. 

Indirizzo: $C160 

Parametri: x indirizzo dello pseudoregistro destinazione in pagina 0 (per esempb Idx 

#r1) 

y indirizzo dello pseudoregistro sorgente in pagina 0 (per esempio Idy #r2) 

Restituisce: (x) il registro puntato da x contiene il risultato da 16 bit 
X, y inalterato 

Distrugge: a, r7, r8 

Sinossi: BBMult moltiplica due byte fra di loro e memorizza il prodotto nella 

destinazione. Se x contiene l’indirizzo di r5, il byte basso del registro r5 (r5L) 
viene usato come primo operando della moltiplicazione. Questo viene 
moltiplicato per il b^e individuato dal registro puntato da y, e il risultato 
deH’operazione, che occupa 16 bit, viene memorizzato nei due byte del 
registro r5. 
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BMult - Moltiplicazione word « byte 


Funzione: Moltiplica fra loro una word priva di segno e un byte privo di segno, e 

memorizza il prodotto nella word puntata da x. 


Indirizzo: $C163 


Parametri: 


X indirizzo dello pseudoregistro destinazione in pagina 0 (per esempio Idx 
#r1) 

y indirizzo dello pseudoregistro sorgente in pagina 0 (per esempio Idy #r2) 


Restituisce: (x) il registro da 16 bit puntato da x contiene il risultato della moltiplicazione 
(y) il byte alto del registro sorgente puntato da y viene azzerato 
X, y inalterati 


Distrugge: a, r6, r8 

Sinossi: BMult moltiplica un byte con una word e memorizza il risultato nella word. Il 

byte operando sorgente è puntato da y. La word operando destinazione è 
puntata da x. Tutti i flag di stato contenuti nel PSW rimangono inalterati. 
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DMult - Moltiplicazione in doppia precisione 


Funzione: Moltiplica fra loro due word prive di segno. 

Indirizzo: $C166 


Parametri: x indirizzo dello pseudoregistro destinazione in pagina zero (per 

esempio Idx #r1) 

y indirizzo dello pseudoregistro sorgente in pagina 0 (per esempio Idx 
#r2) 


Restituisce: 


(x) il registro puntato da x contiene il risultato da 16 bit dell’operazione 

(y) il registro puntato da y rimane inalterato 
X, y Inalterati 


Distrugge: a, r6 - r8 


Sinossi: DMult moltiplica la word sorgente per la word destinazione e memorizza il 

prodotto nella word destinazione. La word operando sorgente è puntata da 
y. La word operando destinazione è puntata da x. Tutti i flag di stato contenuti 
nel PSW rimangono inalterati. 






Ddiv - Divisione in doppia precisione 


Funzione: Divide una word destinazione priva di segno per una word sorgente e 

memorizza il quoziente nella word destinazione, li resto della divisione è 
memorizzato in r8. 

Indirizzo: $0169 

Parametri: x indirizzo dello pseudoregistro destinazione in pagina zero (per 

esempio Idx %1) 

y indirizzo dello pseudoregistro sorgente in pagina zero (per esempio 
Idx#r2) 

Restituisce: (x) il registro puntato da x contiene il risultato da 16 bit deH’operazione 
r8 il resto dell’operazione 
(y) il registro puntato da y non viene alterato 
X, y inalterati 

Distrugge: a, r9 

Sinossi: Ddiv divide una word destinazione per una word sorgente e memorizza il 

risultato nella word destinazione. Il resto della divistone è memorizzato in r8. 
La word operando sorgente è puntata da y. La word operando destinazione 
è puntata da x. Tutti i flag di stato del PSW restano inalterati. Se per esempio 
l’operazione è 4 / 3, la word destinazione riceve il quoziente intero 1 ed r8 
riceve il resto della divisione, cioè 1. 






DSdiv - Divisione in doppia precisene con segno 


Funzione: Divide una word destinazione con segno per una word sorgente con segno 

e memorizza il quoziente nella word destinazione. Il resto della divisione è 
memorizzato in r8. 

Indirizzo: $C16C 

Parametri: x indirizzo dello pseudoregistro destinazione in pagina 0 (per esempio 

Idx #r1) 

y indirizzo dello pseudoregistro sorgente in pagina 0 (per esempio Idy 
#r2) 

Restituisce: (x) il registro puntato da x contiene il risultato da 16 bit dell’operazione 

r8 contiene il resto della divisione 
(y) il registro puntato da y rimane inalterato 

X, y inalterati 

Distrugge: a, r9 

Sinossi: DSdiv divide una word destinazione con segno per una word sorgente con 

segno, e memorizza il quoziente nella word destinazione, li resto della 
divisione viene memorizzato in r8. La word operando sorgente è puntata da 
y. La word operando destinazione è puntata da x. Tuttì i flag di stato del PSW 
sono inalterati. Il calcolo aritmetico viene eseguito con la tecnica del 
complemento a due. Per esempio la divisione 4 / -3 produce il quoziente -1 
memorizzato nella word destinazione e il resto 1 memorizzato in r8. 
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Dabs - Valore assoluto in doppia precisione 


Funzione: Calcola il valore assoluto di una word in connpiemento a due. 

Indirizzo: $C16F 


Parametri: x 

Restituisce: (x) 


indirizzo dello pseudoregistro in pagina 0 (per esempio Idx #r1) 

il registro puntato da x riceve il valore assoluto in complemento a due 
dell'operando in esso originariamente memorizzato 


Distrugge: a 


Sinossi: Dabs calcola il valore assoluto della word memorizzata nel registro puntato 

da X. Tutti i flag di stato del PSW sono inalterati. Il calcolo aritmetico viene 
effettuato in complemento a due. 
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Dnegate - Negazione in doppia precisione con segno 


Funzione: Nega una word in complemento a due. 

Indirizzo: $C172 


Parametri: x 

Restituisce: (x) 

X 


indirizzo della word pseudoregistro in pagina 0 (per esemplo Idx #r1 ) 

la word nei registro puntato da x riceve il risultato deU'operazione 
inalterato 


Distrugge: a. y 


Sinossi: Dnegate nega la word in complemento a due memorizzata nei registro 

puntato da x (cioè ne cambia il segno). Tutti i fiag di stato restano inalterati. 
Il calcolo aritmetico viene effettuato in complemento a due. 
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Ddec - Decrementazione di una word priva di segno 


Funzkme: Decrementa una word priva di segno. 

indirizzo: $C175 


Parametri: x 

Restituisce: (x) 

X 

Distrugge: a 


indirizzo della word pseudoregistro in pagina 0 (per esempio Idx #r1) 

la word priva di segno nel registro puntato da x viene decrementata 
inalterato 


Sinossi: Ddec decrementa la word priva di segno memorizzata nei registro puntato 

da X. Tutti i flag di stato restano inalterati. Il calcolo aritmetico è effettuato per 
valori positivi (non in complemento a due) su 16 bit. 






Funzione: Genera un numero da 16 bit pseudocasuaie. 

Indirizzo: $C187 

Parametri: Nessuno 


Restituiace: random contiene un nuovo numero da 16 bit 

Distrugge: a 

Sinossi: GetRandom produce un nuovo numero da 16 bit pseudocasuale nella 

variabile globale random. L’algoritmo di generazione è il seguente: 

numero nuovo = (numero precedente+1)*2 mod 65521 

Il numero casuale generato è sempre minore di 65221, e ha più o meno 
un’uniforme distribuzione fra 0 e 65221. 
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LIBRERIA DI ROUTINE 
DI UTIEITÀ GENERAEE 


Questa libreria di routine è stata realizzata per la maiùpolazione delle stringhe, gli 
spostamenti di gruppi di dati, le inizializzazioni e altre funzioni di utilità generale. 
Sono routine impiegate anche dal Kernel di GEOS per le operazioni interne. Eccone 
l’elenco schematico, con una breve spiegazione. 

CopyString Copia ima stringa a terminazione nulla in un’altra 

CopyFString Copia una stringa di lunghezza fissa 

CmpString Confronta una stringa a terminazione nulla con un’altra 

CmpFString Confronta due stringhe di lunghezza fissa 

Panie Routine eseguita se il processore incontra l’istruzione BRK 

MoveData Muove un’area di memoria di dimensioni arbitrarie in un’altra 

ClearRam Azzera una zona di memoria di dimensioni arbitrarie 

FillReun Riempie una particolare zona di memoria con il valore di un byte 

InitRam Aggiorna la RAM leggendo una tavola d’inizializzazione 

CallRoutine Esegue la routine con l’indirizzo specificato 

GetSerialNumber Restituisce il numero di serie del Kernel di GEOS 

ToBasic Passa il controllo del processore da GEOS al Basic del C-64 

Firstlnit Inizializza l’intero sistema 

CRC Esegue un checksum (controllo di somma) 

DoInlineReturn Viene eseguita al termine di una routine inline 
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CopyStrìng 


Funzione: Copia una strìnga a terminazione nulla da una zona di memoria a un’altra. 

Indirizzo: $C265 


Parametri: 


X indirizzo dei registro in pagina 0 che Individua la stringa sorgente 

y indirizzo del registro in pagina 0 che individua la stringa destiriazione 


Restituisce: 


((y)) la stringa copiata alla locazione di memoria puntata dai registro che 
a sua volta è puntato da y 


Distrugge: a, x, y 


Sinossi: CopyStrìng cc^ia una strìnga a terminazione nulla di lunghezza arbitraria da 

un’area di memoria a un’altra. È ovvio che la strìnga non deve contenere al 
suo interno dei byte a zero. 
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CopyFString 


Funzione: Copia un numero dato di byte da una zona di memoria a un'altra. 

Indirizzo: $C268 


Parametri: 


X indirizzo deUo pseudoregistro in pagina 0 contenente il puntatore alla 
stringa sorgente 

y indirizzo dello pseudoregistro in pagina 0 corttenente il puntatore alla 
stringa destinazione 
a numero di byte da copiare 


Restituisce: 


((y)) la stringa copiata alla locazione puntata dal registro in pagina 0 che a 
sua volta è puntato da y 


Distrugge: a, x, y 

CopyFString copia una stringa di lunghezza fissa da un’area di memoria a 
un’altra. A differenza di CopyString, la stringa da celare può contenere byte 
a zero. 


Sinossi: 






Funzione: Confronta fra loro due stringhe a terminazione nulla, 

indirizzo: $C26B 


Pa r a m etr i; x indirizzo del registro in pagina 0 contenente H puntatore alla stringa 
sorgente 

y indirizzo del registro in pagina 0 contenente il puntatore alla stringa 
destinazione 

Restituisce: Z flag di zero impostato a 1 se le stringhe sono uguali 

N flag di segno impostato a 1 se il primo byte della stringa sorgente 

diverso dal corrispondente n^la stringa destinazione, è più piccolo dì 
quest’ultimo 

Distrugge: a, x, y 

Sinossi: CmpString confronta una stringa a terminazione nulla di lunghezza arbitraria 

con un’altra. Dal momento che H segno viene trascurtóo nei confronto, se le 
stringhe sono diverse il flag N nel PSW viene impostato a 1 nel caso che il 
byte della stringa sorgente diverso dal corrispondente della stringa 
destinazione sia il minore dei due. 






Funzione: Confronta un assegnato niOTiero df byte contenuti in un’area di memoria con 

i byte contenuti in un’altra area di memoria. 

Indirizzo: $C26E 

Parametri: x indirizzo del registro in pagina zero contenente il puntatore alla stringa 

sorgente 

y indirizzo del registro in pagina zero contenente il fxjntatore alla stringa 
destinazione 

a numero di byte da confrontare 

Restituisce: Z flag di zero a 1 se le stringhe sono uguali 

N flag di segno a 1 se il primo byte dtìla stringa sorgente diverso dal 
corrispondente nella strmga destinjeione, è più ixccolo di quest’ultimo 

Distrugge: a, x, y 

Sinossi: CmpFString confronta una stringa di byte di lunghezza fissa da un’area di 

memoria a un’altra. Dal momento che il numero di byte interessati dal 
confronto viene indicato nel registro a, il massimo numero di byte 
confrontabili è 256. Differentemente da CmpString che interrompe il 
confronto quando incontra un byte a zero nella stringa sorgente, CmpFString 
consente la presenza di zeri nelle stringhe di byte da confrontare. Dal 
momento che il segno viene trascurato nel confronto, se le stringhe sono 
diverse il flag N nel PSW viene impostato a 1 nel caso che il byte della stringa 
sorgente diverso dal corrispondente della stringa destinazione, sia il minore 
dei due. 






Funzione: È il modo standard d’interpretare l’istruzione BRK. Apre un box di dialogo e 

visualizza al suo interno l’indirizzo ai quale il processore ha incontrato 
l’istruzione BRK. 


Indirizzo: $C2C2 

CManmta da: Un errore n^ coéca 

Chiama: DoDIgBox 

Parametri: Nessuno 

Reatituiace: Niente 

Diatrugge: a, x, y, rO - r15, e a volte molto di più 

Sinoaai: Quando il processore incontra un’istruzione BRK, GEOS biocca le chiamate 

di interrupt e apre sullo schermo un box di dialogo in cui si trova l’indirizzo 
dell’istruzione BRK che ha causato l’interruzione. È un’utile tecnica per 
correggere i codici errati che cedono inavvertitamente il controllo del 
processore a una zona di memoria non significativa. Di solito accade che il 
processore esegue istruzioni che di fatto non sono altro che strutture di dati 
0 byte casuali, e fra queste è molto facile che si trovi un byte di valore zero. 
Nel momento in cui il processore tenta di eseguire l’isfruzione BRK che ha 
codice 0, viene eseguita la routine Panie. Questa visualizza un box di dialogo 
che contiene il messaggio “System error near $xxxx", dove $xxxx è l’indirizzo 
dell’istruzione BRK incontrata. Quando GEOS si trova costretto a eseguire 
la routine Panie, il computer diventa completamente inattivo e bisogna 
spegnerlo per poterlo usare di nuovo. 

Se l’applicazione deve gestire l’interruzione BRK con una propria routine, 
deve memorizzarne l’indirizzo del vettore BRKVector. 
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MoveData, LMoveData 


Funzione: Muove un blocco di menìorìa di cBmensioni arbitrarie. 


Indirizzi: MoveData $C17E 

LMoveData $C1B7 

Parametri: Nomali 

rO indirizzo sorgente del blocco 
r1 indirizzo destinazione dei blocco 
r2 numero di byte da muovere 

Inline 

.word indirizzo sorgente del blocco 

.word indirizzo destinazione dei blocco 

.word numero di byte da muovere 

Restituisce: Il blocco di dati è stato trasferito 


Distrugge: a, y, rO, r1, r2 

Sinossi: MoveData muove un blocco di dati di lunghezza arbitraria da un’area di 

memoria a un’altra. L’area sorgente e l’area destinazione possono anche 
sovrapporsi. 
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ClearRam 


Funzione: 

Indirizzo: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Azzera una specifica zona di memoria. 
$C178 

rO numero di byte da azzerare 
r1 indirizzo aJ quale iniziare l’azzeramento 

Niente 

a, y, rO, r1, r2L 

Azzera la zona di memoria specificata. 





Funzione: Riempie una zona di memoria RAM con il contenuto di un particolare byte. 

Indirizzo: FilIRam $C17B 

LFilIRam $C1B4 

Parametri: Normali 

rO numero di byte da riempire 

ri indirizzo del primo byte da aggiornare con il valore del byte specificato 
r2L valore con il quale riempire l’area di memoria specificata 

Inline 

.word numero di byte da riempire 

.word indirizzo al quale iniziare a riempire la memoria 

.byte il valore da memorizzare nell’area di memoria 

Restituisce: Niente 

Distrugge: a, y, rO, ri, r2L 

Aggiorna tutti i byte compresi nell’area indicata con il valore specificato in 
r2L. Questa routine è utile per impostare un’area di memoria con un valore 
diverso da zero. 


Sinossi: 
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InitRam 


Funzione: Costituisce un semplice ed efficace sistema per iniziaiizzare aree di memoria 

separate. 


Indirizzo: $C181 

Parametri: rO indirizzo della tavola d’inizializzazione alia quale la routine fa riferimento 

Restituisce: L’area o le aree di m^mirìa ini^iàKzzate 


Distrugge: a, x, y, rO, r1 

Sinossi: InitRam legge una tavola che indica come iniziaiizzare un’area di memoria 

RAM. È particolarmente utile in due casi. 

1 ) Si desidera iniziaiizzare una zona di memoria rapidamente e in modo 
compatto, e questa inizializzazione dev’essere effettuata con una certa 
frequenza. Per esempio può trattarsi di dover riportare un’applicazione allo 
stato di default. 


2) Si desidera iniziaiizzare un insieme di piccoli segmenti di RAM non 
continui. InitRam diventa particolarmente efficiente quando l’iniziaJizzazione 
è del tipo: «due byte qui, tre byte là». 

La tavola di definizione, puntata da rO, contiene una o più entrate (gruppo 
di dati), ognuna in questa forma: 


.word 


.byte 

.byte valuel, valueZ, ..., valueN 


La prina word specifica la 
locazione della RflM che l'entrata 
corrente deve iniziaiizzare 
Nunero di byte da iniziaiizzare 
Valori da riportare a partire 
dall'indirizzo specificato 
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Nella tavola possono essere presenti molte di queste “entrate”. Se all'inizio 
di una nuova entrata il valore della word è 0, la routine interpreta lo 0 come 
terminatore della tavola. Riportiamo qui di seguito un esempb di tavola di 
definizione composta da due entrate. 


Semplice tavola d ìnizializzazione 


.word 

FirstLocation 

; locazione in netoria da cui 
jconinciare 1'inizializzazione 
;con la prina entrata 

.byte 

3 

;inizializza tre byte 

.byte 

4, 5, 6 

evalori da neBorizzare 

;nei 3 byte allocati a partire 

;da FirstLocation 

.word 

SecondLocation 

jlocazione in nenoria da cui 
jcottinciare 1 ' inizializzazione 
;con la seconda entrata 

.byte 

10 

;inizializza 10 byte 

.word 

30, $FFE5 

jsi possono miscelare word 

.byte 

0, 0, 2, 3, 1 

;e byte, l'importante e' che 
;i byte totali siano 10 

.word 

0 


.word 

0 

;se la word contiene il valore 0 
;al posto di un indirizzo, 

;aH ' inizio dell'entrata, 

; la routine rileva che 
;la tavola e' terminata 





CalIRoutine 

Funzione: Effettua un salto (jmp) indiretto alla routine il cui indirizzo è memorizzato in 

X e in a. 

Indirizzo: $C1D8 

Parametri: a byte basso deil'indirìzzo della routine da chiamare 

X byte alto dell’Indirizzo defla routine da chiamare 

Reatitoiisce: Dipende dalla routine chiamata. CalIRoutine non restituisce niente 

Distrugge: Dipende dalla routine chiamata. CalIRoutine non distrugge niente 


Sinossi: 


CalIRoutine effettua una chiamata indiretta aH’indirizzo passato in a e in x. Se 
a e X valgono 0, nessuna routine viene chiamata e il risultato di CalIRoutine 
è un semplice rts. 




Funzione: Restituisce il numero di serie del Kernel di GEOS. 


Indirizzo: $C196 

Parametri: Nessuno 

Restituisce: rO il numero di serie 

Dismigge: a 

Sinossi: GetSerialNumber restituisce il numero di serie del Kernel di GEOS 

correntemente in memoria. Questo valore è memorizzato nei codici del 
Kernel. Le applicazioni possono aearsi una chiave di funzionamento, 
memorizzando su disco il numero di s«ie del Kernel da cui sono state gestite 
la prima volta. In questo modo l’applicazione cSverrta per cosi ctìre “Kernel 
dipendente”, e si rifiuta di funztonare sa li Kernel in memoria ha un numero 
di serie diverso da quello registrato in origine come chiave. L’applicazione 
funzionerà esclusivamente sotto il Kernel dell’utente che l’ha comprata. Ogni 
Kernel di GEOS ha un numero di serie autonomo e diverso da tutti gli altri. 






Funzione: Passa il controllo da GEOS al Basic del C-64. È possibile indicare un 

comando Basic, o una serie di comandi, in modo che vengano 
immediatamente eseguiti. La routine è anche in grado di caricare in memoria 
un file tramite il turbo di GEOS. 

Indirizzo: $0241 

Parametri: r7 inizio delle variabili Basic in memoria 

rO puntatore alla stringa a terminazione nulla che contiene i comandi 
Basic da impartire automaticamente 

r5 se rSH è diverso da 0, la routine utilizza l’indirizzo contenuto in r5 per 
puntare il File Entry di un file che deve già essere stato predisposto in 
memoria, accede al File Entry e carica il file in memoria tramite i codici 
turbo 

Restituisce: Niente 

Distrugge: In linea di massima tutti i registri 

Sinossi: ToBasic è utilizzata per trasferire il controllo al Basic del C-64. Attiva il Kernel 

del C-64, lo spazio di l/C e la RCM del Basic, e il sistema viene nuovamente 
inizializzato. r7 deve indicare dove inizia lo spazio per le variabili Basic. 
Ouesto indirizzo diminuito di 2 individua il primo byte dello spazio che 
conterrà il file da caricare eventualmente in memoria. 

Se il byte alto r5H è diverso da zero, r5 indica un buffer che dovrebbe 
contenere il File Entry di un file da caricare in memoria. La routine accede 
ai dati contenuti nel File Entry e carica il file in memoria a partire daH’indirizzo 
(r7 - 2), impiegando il turbo di GECS. Attenzione: la routine non si accerta 
che le dimensioni del file siano tali da non oltrepassare l’indirizzo $7FFF, 
limite al di là del quale inizia l’area dati del Kernel di GECS. È necessario 
quindi che l’applicazione verifichi che il file non sia di dimensioni eccessive. 
Se r5H vale zero, la routine non carica in memoria alcun file. 

rO indica l’indirizzo della stringa a terminazione nulla che contiene i 
comandi diretti che il Basic deve eseguire appena riceve il controllo da 
GEOS. I comandi devono essere separati l’uno dall’altro dal carattere CR 
($13), e la stringa non deve contenere più di 40 caratteri. Ogni comando 
dev’essere memorizzato nella stringa esattamente come verrebbe battuto 
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da tastiera, e non deve quindi includere alcun token Basic. L’interprete Basic, 
appena ricevuto il oxìtrolio, esegue la serie di conìandi sequenzialmente. La 
stringa deve terminare con un carat^ece CR e uno zero che ne individua la 
fine. Se non si desidera Impartire alcun comando, si deve passare una 
stringa nulla, cioè con il primo oerattere uguale a zero. 

Per esempio, se l’applicazione deve caricare un file non compatibile GEOS 
e mandarlo in esecuzione, deve poter verificare se le sue dimensioni in 
memoria interferiscono con il Kernel di GEOS. Se # fHe non oltrepassa il limite 
$7FFF, l’applicazione può eseguire la routine ToBasic indicando in r5 
l’indirizzo in memoria del File Entry del file da caricare. In questo modo la 
routine carica il file in memoria tramite il turbo, e successivamente cede il 
controllo al Basic ordinando di eseguire la stringa di comandi contenute in 
r7. Se invece l’applicazione verifica che il file da caricare in memoria è troppo 
grande, non fa altro che aggiungere nella stringa di comandi l’istruzione 
LOAD “Nome File", 8, 1 in maniera che la prima operazione che e«3guirà il 
Basic, sarà il caricamento del file in memoria. U comando successivo 
potrebbe essere l’istruzione RUN o l’tstejzione SY^.(x}oo(x), per mandare in 
esecuzione il file. 





Funzione: Firstlnit effettua una completa partenza “a caldo” del sistema. 

Indirizzo: $C271 

Parametri: Nessuno 


Restituisce: Il sistema nella sua configurazione “a caldo” (Warm Start) 

Distrugge: a, y, rO, r1, r2L 

Sinossi: Firstlnit è la routine chiamata per inizializzare il sistema. Nel capitolo 20 è 

illustrata la tavola che riporta la configurazione di Warm Start (partenza a 
caldo) effettuata da Firstlnit. 





Funzione: CRC effettua il checksum (condotto di somma) su una particolare area di dati. 

Indirizzo: $C20E 


Parametri: rO puntatore all’inizio del gruppo di dati 

r1 numero di byte da conaderare nell’oporazione di checksum 

Restituisce: r2 risultato del checksum 

Distrugge: a, x, y, rO, r1, r3L 

Sinossi: CRC effettua un lungo e complesso controBodi somma neH’area di memoria 

specificata. Per quanto venga chiamato “axitrolk) cft somma", l’algoritmo 
impiegato da CRC non è una somma. Si tratta di un laborioso calcolo che 
viene effettuato sull’intera struttura di dati indicste, senza seguire la 
sequenza dei byte. Il controllo è comunque rigorossmnente logico e 
determina in qualunque caso un risultato diverso se è stato variato anche un 
solo byte all’Interno della struttura di dati interessata. 

Se si desidera proteggere un programma da alterazioni su disco, è 
sufficiente inserirvi all’Interno la routine che effettua il controlio di somma 
chiamando CRC, e, con un programma a parte, chiamare CRC per ottenere 
il controllo di somma sull’intero programma, lasciando ovviamente fuori dal 
controllo la word che andrà a contenere il valore ottenuto. In questo modo 
si è sicuri di identificare subito qualunque alterazione nei codici del 
programma. 






Funzione: Esegue il ritorno da una subroutine per le routine inline. Il Kernel di GEOS la 

esegue per diverse routine inline, e anche le applicazioni possono impiegarla 
per gestire ai proprio interno routine inline. 

Indirizzo: $C2A4 

Parametri: a numero di byte parametri + 1 

stack deve contenere come ultimo byte il PSW 

returnAddress indirizzo primo byte parametro - 1 

Restituisce: Niente 

Distrugge: a 

Sinossi: Vediamo come una routine può trarre vantaggio dal passagio dei parametri 

inline e come viene impiegata DoInlineRetum. La routine inline, appena 
ricevuto il controllo, deve memorizzare nella variabile returnAddress 
l’indirizzo di ritorno da subroutine contenuto nello stack. Questo indirizzo non 
punta però al primo byte dopo la chiamata jsr Routine (Routine è la nostra 
ipotetica routine), ma alla locazione di memoria appena precedente. 
Supponendo che l’istruzione jsr Routine si trovi all’indirizzo $1 (XX), sullo stack 
viene memorizzata la word $1CX)2 che, incrementata di uno, costituisce 
l’indirizzo di ritorno della subroutine. Una volta che Routine ha salvato, 
svuotando lo stack, l’indirizzo di ritorno - 1 nella variabile returnAddress, 
procede alla lettura dei parametri che seguono la chiamata jsr Routine. Per 
accedervi impiega la variabile returnAddress e l’indice y inizialmente a 1, e 
non a 0 come si potrebbe pensare. Routine conosce esattamente il numero 
di byte parametri che deve leggere e procede incrementando per ognuno 
l’indice y. 

Quando Routine ha prelevato tutti i parametri che le competono, inizia lo 
svolgimento della sua funzione. Compiute tutte le operazioni. Routine deve 
restituire il controllo alla routine di livello superiore che l’ha mandata in 
esecuzione. Per far questo, deve inizialmente salvare sullo stack il PSW 
eseguendo l’istruzione php. Quest’operazione è necessaria perché DoInline¬ 
Retum potrebbe alterare alcuni flag che Routine restituisce come parametri 
di output. Successivamente deve memorizzare nell’accumulatore il numero 
di byte parametri + 1 che sono stati passati, ed eseguire l’istruzione 
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jmp DoinlineRetum (nota bene: la chiamata a DdnlineRetum dev'essere 
assolutamente eseguita tramite l’istruzione jmp). A questo punto è già stato 
effettuato il ritorno da subroutine. 

Supponiamo che Routine debba ricevere soltanto due byte parametri e 
vediamo come dev’essere organizzata. 


Routine; 



Pop 

returnfiddress 

jpreleva la word di ritorno dallo stack 
je la nenorizza in returnfiddress 

Idy 

«01 

jayyiorna 1'indice a 1 

Ida 

(returnfiddress), y 

jpreleva il priao byte paraaetro 

sta 

datol 

;e lo aeaorizza 

iny 


jincreaenta l'indice 

Ida 

(returnfiddress), y 

jpreleva il secondo byte paraaetro 

sta 

dato2 

je lo aeaorizza 



jla routine svolge i suoi coapiti 

php 


jsalva il PSU 

Ida 

#(2 + 1) 

jnuaero di byte paraaetri + 1 

j»P 

DoinlineRetum 







I BOX 

DI DIALOGO 


I box di dialogo appaiono come un rettangolo sullo schermo all'interno del quale 
possono trovarsi testi, icone e stringhe, manipolabili in diversi modi. 1 box di dialogo 
vengono utilizzati dalle applicazioni per segnalare all’utente condizioni d’errore, 
avvisarlo della possibilità che si verifichino situazioni indesiderate, attendere frasi in 
input dall’utente, creare una lista di nomi di file per operare una selezione o soddisfare 
altre esigenze di dialogo fra l’utente e l’applicazione. Tra le strutture di box di dialogo 
impiegate più frequentemente, alcune sono già disponibili nel Kernel di GEOS. Usati 
nell’ambito delle funzioni realizzate dal programmatore, i box di dialogo costituiscono 
un’interfaccia utente semplice, compatta e molto flessibile. 

Un box di dialogo può essere aperto sullo schermo in qualsiasi momento. Si può 
considerare come una piccola applicazione che viene eseguita nell’ambiente che le è 
proprio. Non altera in alcun modo l’esecuzione dell’applicazione corrente e non cambia 
le sue variabili (tranne nel caso in cui il programmatore abbia previsto una routine di 
servizio associata che volutamente agisca sulle variabili dell’applicazione). Chiaman¬ 
do l’apertura di un box di dialogo, la maggior parte dello stato della macchina viene 
provvisoriamente salvato. Tutte le variabili del Kernel, i vettori, le strutture dei menu 
e delle icone vengono preventivamente salvati. Quindi i box di dialogo possono essere 
anche molto elaborati, dal momento che non corrono il rischio d’intaccare lo stato del 
sistema. Un’eccezione è costituita dagli pseudoregistri rOH - rl5 che non vengono 
salvati. 11 metodo per ripristinare la parte di schermo coperta dal box di dialogo (BD), 
nel caso che non sia abilitato il buffer di schermo, è descritto in questo stesso capitolo. 

Per aprire un box di dialogo si deve chiamare la routine DoDlgBox, mentre per 
chiuderlo e restituire il controllo all’applicazione si deve eseguire la routine 
RstrFrmDialogue. Tutte le variabili necessarie per gestire un box di dialogo sono 
riassunte in una tavola di definizione semplice, ma molto funzionale. Questa tavola 
specifica le dimensioni del BD e le sue funzioni. È composta da una serie di byte 
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comando e dai byte parametri associati. I byte comando di un BD possono indicare 
icone da visualizzare o comandi (normalmente per visualizzare testi) da eseguire 
mentre il BD è aperto. I byte parametri di un BD specificano informazioni come la 
locazione del BD, le sue dimensioni e le stringhe da visualizzare. 

Lungo la tavola di definizione del BD, uno 0 al posto di un byte comando indica la 
fine della tavola. 


Le icone e i comcuidi per gestire i box di dialogo 

Il Kernel di GEOS supporta al suo interno un set di icone residenti, realizzate per 
essere utilizzate airintemo dei BD. Le icone dei BD rappresentano un metodo semplice 
per rispondere a domemde o considerazioni dell’applicazione. Quamdo l'utente preme 
il pulsante del mouse su una delle icone visualizzate, normalmente il BD si cancella, 
il numero dell'icona selezionata viene restituito in rOL e viene automaticamente 
eseguita la routine RstrFrmDialogue. L’applicazione che aveva aperto il BD deve poi 
leggere il contenuto di rOL e operare di conseguenza, di solito chiamando la routine 
di servizio associata all’icona selezionata. Sono disponibili in GEOS le icone per i BD 
che indicano YES, NO, OK, OPEN e DISK. 

I comandi dei BD sono utili per chiamare routine arbitrarie, per visualizzare stringhe 
di testo, per ricevere in input stringhe di testo, per visualizzare un box aU’interno del 
quale effettuare lo scroll dei nomi di alcuni file, per visualizzare un’icona definita 
dall’utente é per definire un vettore che pimta a una routine da eseguire se l’utente 
preme il pulsante del mouse in un’area del box di dialogo diversa da un’icona. I 
comandi pei; i BD sono composti da un byte che specifica il numero del comando ed 
eventualmente alcuni byte parametri. 


La struttura dei box di dialogo 

La prima informazione in una tavola di definizione di un BD è un byte comando che 
ne definisce la posizione. Questo comemdo può specificare una posizione di default per 
il BD, DEF-DB-POS, o indicare una posizione definita dall’utente, SET_DB_POS, nel 
qual caso devono seguire le informazioni necessarie perché GEOS possa visualizzare 
i BD di dimensioni non standard. 

Il byte di comando che definisce la posizione del BD è OR’ed, con il numero di una 
matrice grafica di sistema con la quale riempire l’ombra del BD. Il box ombra del BD 
è un rettangolo delle stesse dimensioni del BD ed è riempito con un’opportuna matrice 
grafica di sistema. Il box ombra appare sotto il BD ed è spostato rispetto al BD di 8 bit 
a sinistra e 8 bit verso il basso. Se il numero della matrice grafica corrisponde a 0 il 
box ombra non è richiesto. È senz’altro più facile farsi un’idea precisa di un BD 
associato al suo box ombra tramite un esempio, piuttosto che con lunghe descrizioni. 
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Nel corso del capitolo, nell'esempio OpenBox, viene descritta a questo scopo una figura 
con un BD completo di box ombra. 

Le due forme del byte comando di posizione, che indicano rispettivamente un BD 


di dimensioni di default e un BD di 

.byte 0EF.0B-P0S|pattern .byte 

dimensioni definite dall’applicazione, sono: 

SET-DB-POS|pattern 

.byte 

latoSuperiore 

;<0 - 199) 

.byte 

latoinferiore 

;(0 - 199) 

.word 

latoSinistro 

;(0 - 319) 

.word 

»_ i* j» _•_•_ 

latoDestro 

;(0 - 319) 


I comandi di posizione 


Dopo il byte, o il gruppo di byte, che definisce la posizione e le dimensioni del BD, 
possono seguire sia byte icona che byte comando. L’icona OK è la più frequente. Il byte 
che specifica l’icona OK è seguito da due byte che definiscono la posizione orizzontale 
e verticale come offset relativi all’angolo sinistro in alto del BD. Il primo è la coordinata 
X dell’icona misurata in byte (0 - 39); il secondo è la coordinata y dell’icona misurata 
in pixel (0 -199). La definizione dell’icona OK deve seguire questa traccia 


.byte 

OK 

icostante 

che identifica l’icona OK 

.byte 

xOffset 

;<0 - 39 

byte) 

.byte 

yOffset 

;<0 ■ 199 

pixel) 

n byte 

icona OK 




Quando un BD è attivato e l’utente seleziona una delle icone disponibili, il BD 
scompare e il sistema restituisce in rOL il numero dell’icona selezionata. L’appUcazio- 
ne, accedendo a rOL, può eseguire le operazioni legate alla scelta dell’utente. 
AU’interno di un BD non possono essere visualizzate più di otto icone. 

La tavola riportata nella pagina successiva elenca i comandi per gestire le icone 
aH’interno di un BD. 
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Icone per i box di dialogo 


Icona 

Valore 

Esempio 

OK 

1 

.byte OK 

.byte xpos-in-byte 
.byte ypos-in-pixel 

CfiNCEL 

2 

.byte CfiNCEL 
.byte xpos-in-byte 
.byte ypos-irr-pixel 

YES 

3 

.byte YES 

.byte xpos-in-byte 

.byte ypos-in-pixel 

NO 

4 

.byte NO 

.byte xpos-in-byte 
.byte ypos-iri-pixel 

OPEN 

5 

.byte OPEN 
.byte xpos-in-byte 
.byte ypos-in-pixel 

DISK 

6 

.byte DISK 
.byte xpos-in-byte 
.byte ypos-in-pixel 

FUTURE 1 

7 

.byte FUTUREl 
.byte xpos-in-byte 
.byte ypos_in_pixel 

FUTURES 

8 

.byte FUTURES 
.byte xpos-in-byte 
.byte ypos-in-pixel 

FUTURES 

9 

.byte FUTURES 
.byte xpos-in-byte 
.byte ypos-in-pixel 


FUTURE4 


10 


.byte FUTURE4 
.byte xpos-in-byte 
.byte ypos-iri-pixel 
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I comandi dei box di diatogo 

Numerosi comandi sono stati previsti per conferire autonomia e flessibilità ai BD. 
Molti riguardano la visualizzazione di testi aU’interno dei BD. Per esempio, il comando 
DBTXTSTR (il cui valore è 11 ) è seguito da due byte posizione e da una word che punta 
a una stringa di testo da visualizzare. Quando questo comando è impiegato alPinterno 
di un BD, la posizione in cui iniziare a visueiiizzare il testo (coordinate x e y) si riferisce 
all’angolo sinistro in alto dello schermo. Le due coordinate sono misurate in pixel; la 
y si misura dal lato superiore del BD alla linea di base della stringa da visualizzare, 
mentre la x si misura dal lato sinistro del BD al lato sinistro del primo carattere della 
stringa. Le stringhe da visualizzare non possono avere una distanza orizzontale 
superiore a 256 pixel dal lato sinistro del BD. 

Per passare i parametri ai comandi si possono impiegare i registri da r5 a rlO, ed rl5. 
Vediamo ora i comandi disponibili. Successivamente analizzeremo nei dettagli quelli 
più complessi. 
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DBTXTSTR - Dialog Box Text String (Strìnga dì testo per BD) 


Codice del comando: 11 

L'esempio che segue mostra la struttura del comando. DBTXTSTR visualizza la stringa di testo puntata da TextRr, 
posizionandola all’Interno del BD secondo le due coordinate xpos_offset e ypos_offset espresse in pixel e riferite 
all’angolo sinistro in alto del BD. TextRr contiene l’indirizzo della stringa a terminazione nulla da visualizzare. 


.byte 

DBTXTSTR 

. byte 

xpos-of fset 

, byte 

ypos-offset 

, word 

TextPtr 


jbyte coiriando 

;offset dal lato sinistro del BD espresso in pixel (8 - 256) 
;offset dal lato superiore del BD espresso in pixel (8 - 199) 
;puntatore alla stringa a terminazione nulla 


DBVARSTR - Dialog Box Variable Text String (Stringa di testo variabile per BD) 


Codice del comando: 12 


L’esempio che segue mostra la struttura del comando. DBVARSTR, a differenza di DBTXTSTR, visualizza la stringa 
a terminazione nulla puntata dal registro il cui indirizzo è contenuto in regAddr. Se regAddr è uguale a r5 ($0C), indica 
il registro r5. La stringa da visualizzare può essere diversa a ogni apparizione del BD secondo le esigenze 
dell’applicazione. La stringa è visualizzata all’Interno del BD nella posizione indicata dalle due coordinate xpos-offset 
e ypos-offset, espresse in pixel e riferite all’angolo sinistro in alto del BD. 


. byte 

DBVfìRSTR 

.byte 

xpos-of fset 

. byte 

ypos-offset 

.byte 

regfiddr 


jbyte comando 

joffset dal lato sinistro del BD espresso in pixel (8 - 256) 
joffset dal lato superiore del BD espresso in pixel (8 - 199) 
; indirizzo del registro (r5 - rlB, rl5) 


DBGETSTRING - Dialog Box Get Text String (Input di una stringa con BD) 


Codice del comando: 13 

Riceve una stringa di testo proveniente in input dall’utente e la memorizza nel buffer indirizzato dal registro il cui 
indirizzo è specificato in regAddr. Il comando riporta anche l’eco sullo schermo, nella posizione indicata dalle 
coordinate xpos_offset e ypos-offset espresse in pixel e riferite all’angolo sinistro in alto del BD. maxChars è il 
massimo numero di caratteri memorizzabili nel buffer. 
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.byte 

DBGETSTRING 

jbyte comando 


. byte 

xpos-offset 

joffset dal lato sinistro del BD espresso in pixel (0 - 

256) 

.byte 

ypos-of fset 

joffset dal lato superiore del BD espresso in pixel (0 

- 199) 

.byte 

regflddr 

jindirizzo del registro (r5 - rl0j rl5) 


.byte 

maxChars 

jmassimo numero di caratteri da memorizzare nel buffer 



DBSYSOPV - Dialog Box System Other Press Vector 


Codice del comando: 14 

Questo comando permette all’utente di chiudere il BD premendo il pulsante del mouse quando questo si trova 
in un'area diversa da un'icona. Se per esempio il BD è aperto semplicemente per visualizzare i nomi degli autori 
dell'applicazione, non c'è bisogno di alcuna icona e l’utente può chiudere il BD premendo il pulsante del mouse in 
un’area qualunque. 

.byte DBSYSOPy jbyte comando 


DBGRPHSTR - Dialog Box Graphics String 


Codice del comando: 15 

Questo comando ordina a GEOS di eseguire la stringa grafica (graphics string) indicata da grphStrRr. 
.byte DBGRPH'STR jbyte comando 

.word grphStrPtr jpuntatore alla stringa grafica da eseguire 


DBGETFILES - Dialog Box Get Files (Selezione dei file nei BD) 


Codice del comando: 16 

Questo comando apre aH’interno del BD una finestra che elenca nomi di file. Al suo interno GEOS elenca una serie 
di nomi di file letti da disco e raggruppati secondo una chiave di ricerca. L’utente può selezionare uno qualunque 
dei nomi di file visualizzati. Il nome di file selezionato viene copiato nel buffer indicato dal registro r5. La “chiave” per 
la ricerca dei file i cui nomi devono essere visualizzati nella finestra è il tipo del file. Normalmente si impiega questo 
sistema di selezione per permettere all'utente di scegliere un file fra tutti quelli dello stesso tipo presenti sul disco. 
Per esempio, quando l'utente vuole selezionare il driver di input in deskTop, aH’intemo del box di selezione 
compaiono esclusivamente i file di tipo INPUT-DEVICE. Il tipo di file che si desidera impiegare come chiave di ricerca 
dev’essere memorizzato in r7L. Esiste anche la possibilità di indicare una seconda chiave, utile per raggruppare file 
creati da una stessa applicazione. Con questa seconda chiave, subordinata alla prima, il campo di ricerca su disco 
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dei file si restringe uiteriormente. Di solito le applicazioni creano file di tipo APFC-DATA. Questa informazione non 
è però sufficiente per raggruppare solo i file di tipo APPL-DATA di una particolare applicazione. Fortunatamente a 
ogni file, oltre il tipo del file, è associato anche un nome permanente (permanent name) che ne specifica ulteriormente 
la provenienza. Questo nome permanente è la seconda chiave di ricerca. Memorizzando inrfO, di solito azzerato, 
l’indirizzo di una stringa a terminazione nulla che contenga il nome permanente, si genera la seconda chiave di ricerca 
che restringe il campo di raggruppamento. In questo modo GEOS raggruppa tutti i file del tipo specificato e 
provenienti dalla stessa applicazione. Il nome permanente, come vedremo, è memorizzato nel File Header del file 
ed è generato dall’applicazione che ha creato il ffle. Se per esempio r10 indica il nome permanente “Paint Image", 
all’Interno della finestra di selezione compariranno esclusivamente i file generati dall’applicazione geoPaint. Se sullo 
stesso disco vi sono più file di quanti ne possa visualizzare contemporaneamente la finestra, compaiono nella parte 
sottostante alla finestra due frecce indicanti le due direzioni verticali di scroll della lista all’interno della finestra. Questo 
comando è in grado di creare una lista contenente un numero massimo di 16 file. 

.byte DBGETFILES jbyte comando 

.byte xpos-offset joffset dal lato sinistro del BD in pixel (8 - 255) della finestra 

.byte ypos-offset joffset dal lato superiore del BO in pixel <8 - 199) della finestra 

r7L - tipo del file in ambiente GEOS 

r5 - puntatore al buffer al quale restituire il nome del file selezionato 

rl8 - puntatore al nome permanente (stringa a terminazione nulla) del file 

per restringere il campo di ricerca 


DBOPVEC - Dialog Box User Other Press Vector 


Codice del comando: 17 

Questo comando permette all’applicazione di specificare in userVector l’indirizzo di una routine da eseguire se 
l’utente preme il pulsante del mouse in un’area del BD diversa da un’icona. Questa routine può terminare con un 
rts restituendo il controllo ai codici di gestione del BD, o può eseguire l’istruzione jmp RstrFrmDialogue per chiudere 
il BD e restituire il controllo all’applicazione. 

.byte DBOPVEC jbyte comando 

.word userVector jotherPressVec definito daH'utente 


DBUSRICON - Dialog Box User Icon (Icona non standard per i BD) 


Codice del comando: 18 

CXiesto comando permette all’applicazione di definire e visualizzare alPintemo del BD un’icona diversa da quelle 
standard per i BD. La tavola di definizione dell’icona (UsrJcn-Tab) include i puntatori ai dati grafici dell’icona e alla 
routine di servizio associata. Quando l’icona viene attivata, GEOS effettua un jsr alla routine di servizio associata. 
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Questa routine può eseguire un jmp RstrFrmDialogue per chiudere il BD o effettuare un rts per ricedere il controllo 
ai codici di gestione del BD. In quest'ultimo caso l’applicazione deve avere previsto aH'intemo del BD qualche altro 
modo per chiuderlo, per esempio una differente icona. La routine, detenendo il controllo, può anche riconfìgurare 
interamente il BD. 


.byte 

DBUSRICON 

;byte comando 

.byte 

xpos-offset 

;coordinata x dell'icona in byte riferita al lato sinistro 



;del BD (B - 39) 

.byte 

ypos-offset 

jcoordinata y dell'icona in pixel riferita al lato superiore 



jdel BD (0 - 199) 

.word 

Usr-Icn-Tab 

jpuntarore alla tavola di definizione dell'icona 

Usr-Icn-Tabi 


.word 

iconPic 

^puntatore ai dati grafici dell'icona 

.byte 

0 

)coordinata x (ignorata) 

.byte 

e 

scoordinata y (ignorata) 

.byte 

uidth-bytes 

;la larghezza di 6 byte e' «luella di default per le icone dei BD 

.byte 

height-pixels 

! jl'altezza di 16 pixel e' quella di default per le icone dei BD 

.word 

Serv-Routine 

; routine di servizio associata all'icona 

1 DB 

USR ROUT - 

Dialog Box User Routine | 


Codice del comando: 19 

Questa funzione permette di personalizzare completamente un BD. La routine puntata da userVector viene 
eseguita appena dopo che il BD è stato visualizzato, e può effettuare qualunque tipo di operazione riguardi il BD. 
Per restituire il controlto ai codici di gestione dei BD, può effettuare un rts, a meno che non sia stato pH^edisposto 
un altro modo per chiuda-e il BD e l’utente l’abbia selezionato. Si tratta comunque di un comando che offre molte 
possibilità diverse, e torneremo a parlarne in seguito. 

.byte DB-USR-ROUT jbyte comando 

.word userVector ;puntatore alla routine definita dall'applicazione di gestione del BD 




244 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


DBOPVEC 

DBOPVEC imposta un vettore che contiene Tindirizzo di una routine da eseguire 
quando l’utènte preme il pulsante del mouse in un’area diversa da un’icona. La routine 
può terminare con un rts, nel qual caso il controllo viene restituito ai codici di gestione 
dei BD contenuti in MainLoop. In seguito si possono eseguire altri comandi per le 
icone, per i box di dialogo o selezioni di icone. 

Se il programmatore desidera che la routine termini chiudendo il BD e restituendo 
il controllo aU’applicazione, come accade con il comando DBSYSOPV, deve terminare 
la routine con l’istruzione jmp RstrFrmDialogue. Quando la routine termina 
restituendo il controllo aU’applìcazione, deve memorizzare nella variabile globale 
sysDBData un codice di riferimento per l’applicazione che chiarisca la ragione per cui 
il BD è stato chiuso. RstrFrmDialogue trasferisce il contenuto di questa variabile 
globale in rOL. Nel caso che l’utente possa chiudere il BD in modi diversi, è importante 
che l’applicazione riceva in rOL il codice del particolare comando impartito. La routine 
prevista daU’applicazione per servire il comando DBOPVEC, deve restituire in 
sysDBData il valore del codice di riferimento assunto dall'applicazione per descrivere 
la causa della chiusura del BD. Questo codice non dev’essere uno di quelli utilizzati 
quando l’utente seleziona una delle icone standard per i BD. Dal momento che un BD 
non può gestire più di otto icone contemporaneamente, è sufficiente associare codici 
maggiori di 8 alle altre condizioni di uscita previste dalla routine di servizio del 
comando. 


DBUSRICON 

Se l’applicazione deve definire aU’interno del BD un’icona diversa da quelle 
standard, può utilizzare il comando DBUSRICON per definirla e attivarla. Nei vari 
parametri che seguono il byte comando vi è una word che specifica l’indirizzo della 
tavola di definizione dell’icona. La struttura di questa tavola di definizione presenta 
sostanziali differenze da quella utilizzata per definire le icone di un'applicazione. Come 
si può osservare nella precedente descrizione del comando, i byte coordinate x e y 
all’interno della tavola di definizione sono impostati a zero. GEOS per collocare l'icona 
all’interno del BD utilizza i byte posizione specificati appena dopo il byte comando. La 
routine di servizio associata all’icona è indicata aH’interno della tavola di definizione 
e viene eseguita non appena si seleziona l’icona. Come avviene per DBOPVEC, anziché 
restituire il controllo all’applicazione come fanno le icone di sistema, queste icone 
definite dall’applicazione restituiscono il controllo ai codici di gestione dei BD presenti 
in MainLoop, eseguendo l’istruzione rts. Il BD può contenere altre icone, per esempio 
di sistema, che se vengono selezionate chiudono il BD, come CANCEL o OK. 

Se invece il programmatore desidera che l’icona definita dall’applicazione chiuda il 
BD e restituisca il controllo al codice che ha fatto la chiamata, deve concludere la 
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routine di servizio associata all’icona con l'istruzione jmp RstrFrmDialogue. Come 
accade per il comando DBOPVEC, la routine associata a DBUSRICON dovrebbe 
memorizzare nella variabile globale sysDBData il codice di chiusura che successiva¬ 
mente RstrFrmDialogue trasferisce in rOL. Questo numero dev’essere diverso da quelli 
assegnati alle icone di sistema, per non creare ambiguità. 


DBGETFILES 

11 comando DBGETFILES è sicuramente il più importante comando disponibile per 
i BD. La figura che segue illustra l’impiego di questo comando. 



Possiamo qui osservare la finestra all’interno del BD che elenca i nomi di alcuni file. 
Se esistono sul disco più file di quanti la finestra ne possa contenere, appaiono nella 
parte bassa del BD due frecce con le punte una verso il basso e una verso l’alto. Agendo 
su di esse con il mouse, l’utente può scorrere l’intera lista di nomi, anche se la finestra 
ne visualizza solo una parte. In questo modo non possono essere raggruppati più di 16 
nomi di file ma di solito è già una quantità sufficiente. Quando il BD è aperto e il 
comando viene eseguito, il registro r7L deve contenere il tipo di file secondo lo 
standard GEQS (SYSTEM, DESK-ACC, APPLICATIQN, APPL_DATA, FQNT, PRIN¬ 
TER, INPUT-DEVICE, DISK-DEVICE...). Questa è la chiave principale di raggruppa- 
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mento dei nomi; r5 deve puntare a un buffer entro il quale sarà restituito il nome del 
file selezionato. Se l’applicazione, prima di attivare il BD, memorizza in questo buffer 
una stringa a terminazione nulla contenente il nome di un file, questo sarà il primo a 
essere visualizzato nel box, e come tale sarà scritto in negativo. 

Selezionare un file significa memorizzarne il nome nel buffer puntato da r5 e farlo 
diventare una stringa a terminazione nulla (terminandolo con uno 0). Se rlO è 0 
vengono raggruppati tutti i file del tipo specificato. Se invece rlO punta a una stringa 
a terminazione nulla, questa viene assunta come seconda chiave di ricerca e 
rappresenta il nome permanente (permanent name) associato al file. Tramite questa 
seconda chiave di selezione è possibile restringere la ricerca di file dello stesso tipo 
raggruppando esclusivamente quelli creati dalla stessa applicazione. La stringa “nome 
permanente" è memorizzata nel blocco File Header del file e dovrebbe essere generata 
dall'applicazione all’atto della creazione del file. Essa contiene un nome generato 
dall’applicazione e dovrebbe identificare tutti i file creati dalla stessa applicazione. Per 
esempio, a geoPaint dovrebbe interessare aprire e gestire solo file di sua creazione, e 
non tutti i possibili file dati presenti sul disco. Se geoPaint, all’apertura di un BD per 
selezionare il file su disco, specifica in rlO l’indirizzo della stringa “Paint Image”, 
verranno raggruppati solo i file con quel nome permanente. Questa seconda chiave di 
ricerca, subordinata alla prima, diventa particolarmente utile quando si desidera 
raggruppare, per esempio, solo quei file di tipo APPL-DATA generati da una 
particolare applicazione. 

Dal momento che un esempio è spesso molto più chiaro di una spiegazione, più 
avanti riportiamo una piccola tavola di definizione che illustra l’impiego di questo 
comando. 


DB-USR-ROUT 

Il comando DB-USR-ROUT ordina a GEOS di chiamare una routine di gestione del 
BD, elaborata dall’applicazione, quando il BD è stato visualizzato. La routine può essere 
anche molto complessa. Può per esempio impostare processi temporizzati, visualizzare 
finestre e così via. Dal momento che DoDlgBox e RstrFrmDialogue, rispettivamente, 
salvano e ripristinano lo stato del sistema, la routine di gestione del BD associata al 
comando DB-USR-ROUT non rischia di alterare in alcun modo lo stato della macchina 
precedente alla chiamata di DoDlgBox. In appendice sono evidenziate tutte le aree di 
memoria che vengono salvate durante l’apertura di un BD, e nella descrizione della 
routine LdDeskAcc (vedere il capitolo 15) è illustrata una lista di queste aree. Il motivo 
per cui queste aree vengono descritte nell’ambito della routine LdDeskAcc risiede 
nella stretta similitudine che lega i desk accessory ai box di dialogo; per entrambi, 
prima che vengano aperti, GEOS salva le aree di memoria che caratterizzano lo stato 
del sistema in una particolare zona della memoria, trasparente alle applicazioni. 
L’unica limitazione dei box di dialogo consiste nell’impossibilità di chiamare la 
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routine Dolcons se aU’interno del BD sono state già attivate le icone standard, dal 
momento che i due set di icone interferirebbero l’uno con l’altro. 

La struttura di icone possiamo attivarla e visualizzarla, dopo l’esecuzione del 
comando DB-USR-ROUT, grazie a comandi di altro tipo. Solo in questo modo un’icona 
può essere visualizzata sopra un disegno realizzato dalla routine associata al comando 
DB-USR_ROUT. La routine, se si desidera che gli altri comandi che la seguono nella 
tavola di definizione del BD siano eseguiti, deve restituire il controllo ai codici di 
gestione dei BD presenti in MainLoop tramite l’istruzione rts. 


La chiusura di un box di dialogo 

La parte di schermo coperta dal BD aperto può essere visualizzata di nuovo in due 
modi. Se lo schermo principale-è stato copiato nel buffer di schermo, è sufficiente 
chiamare la routine RecoverRectangle che copia un rettangolo dal buffer di schermo 
allo schermo principale. Questa operazione viene automaticamente effettuata dal 
Kernel. Se invece il flag dispBufferOn è impostato in modo tale che il buffer di schermo 
contenga soltanto codici, e non una copia dello schermo principale, l’applicazione deve 
provvedere a im altro modo per ripristinare lo schermo precedente all’apertura del BD. 

Quando viene eseguita, RstiFrmDialogue chiama la routine il cui indirizzo è 
memorizzato nel vettore recoverVector. Normalmente questo vettore contiene 
l’indirizzo della routine RecoverRectangle. Per ripristinare lo schermo principale dopo 
la chiusura di iip BD, devono essere effettuate due chiamate attraverso recoverVector. 
La prima, effettuata da RstrFrmDialogue, è eseguita con le coordinate del box ombra 
del BD, ripristinando così l’area coperta dall’ombra del BD. La seconda chiamata 
attraverso recoverVector, sempre effettuata da RstrFrmDialogue, viene eseguita con le 
coordinate del BD. In questo modo si ripristina completamente l’area coperta dal BD 
e dalla sua ombra. 

Se l’applicazione non utilizza il buffer di schermo per mantenere una copia dello 
schermo principale, deve memorizzare in recoverVector un ulteriore indirizzo di una 
routine che ripristini in qualche modo lo schermo principale. Le dimensioni dell’area 
da ricreare vengono passate negli stessi registri utilizzati da RecoverRectangle: r2 - r4. 
La routine di “ripristino schermo", puntata da recoverVector, sarà chiamata due volte 
e potrà utilizzare le dimensioni dell’area da ripristinare contenute nei registri r2 - r4. 
Se la routine risolve il problema con una sola esecuzione, deve contenere un flag che 
alla seconda chiamata le faccia effettuare un semplice rts. 
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Esempio di box di dialogo: OpenBox 

Descrizione: Questa tavola di definizione è tratta da geoWrite e definisce un box di dialogo 
che permette all’utente di creare un nuovo documento, di aprire un 
documento già esistente o di terminare l’applicazione. 
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OpenBox; 
.byte 

DEF-DB-POSIl 

;BD standard realizzato da GEOS e matrice grafica 1 per rombra 

• byte 

DBTXTSTR 

.ivisualizza la stringa 

.byte 

TXT-LN-X 

jposiziona la stringa all'offset orizzontale standard 

.byte 

2*8 

;(16 pixel) 

.loffset y in pixel dal lato superiore dello schermo 

.word 

selectOptionTxt 

jpuntatore al messaggio "Please Select Optioni'' 

.byte 

DBUSRICON 

jicona CREATE definita dal programmatore 

.byte 

2 

joffset X in byte dal lato sinistro del BD al lato sinistro 

. byte 

3*8 

jdell'icona 

,'Offset y in pixel dal lato superiore del BD al lato 

.word 

createlcon 

;superiore dell'icona 

jpuntatore alla tavola di definizione dell'icona CREATE 

, byte 

DBTXTSTR 

jvisualizza il testo "new document" 

, byte 

<2+6)*8+7 

joffset X in pixel 1 (2 + larghezza icona) * 8 pixel + 7 

.byte 

3*8+10 

joffset y in pixel; 10 pixel sotto il lato superiore 

. word 

newOptioriTxt 

jdel l'icona CREATE 

jpuntatore al testo "new document" 

.byte 

OPEN 

jicona standard di sistema OPEN 

.byte 

2 

joffset x in byte 

.byte 

6*8 

joffset y in pixel; 24 pixel sotto l'icona CREATE 

.byte 

DBTXTSTR 

jposiziona il testo "existing document" alla destra 

.byte 

(2+6)*8+7 

jdell'icona 

joffset X in pixel; (2 + larghezza icona) * 8 pixel + 7 

.byte 

6*8+10 

joffset y in pixel; 24 pixel al di sotto “new docuuient" 

.word 

openOptionTxt 

jpuntatore "existing document" 
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.byte 

[iBUSRICON 

.byte 

2 

.byte 

9*8 

.word 

qui t Icori 

.byte 

DBTXTSTR 

.byte 

(2+6)18+7 

.byte 

3*8+10 

.word 

quitOptionTxt 

.byte 

0 


il'applicazione definisce un'icona personalizzata 
.loffset X in byte per il lato sinistro dell'icona 
joffset y in pixel per il lato superiore dell'icona 
jpuntatore alla tavola di definizione dell'icona QUII 

;visualizza il testo "to deskTop" 

.1 offset XI (2 + larghezza dell'icona) t 8 pixel + 7 
loffset y in pixeli 24 pixel sotto il lato superiore 
jdell'icona Open 

jpuntatore al testo "to deskTop" 
jfine della tavola di definizione del BD 


selectOptionTxt; jla stringa contiene i caratteri di controllo dello stile 


.byte 

PLflINTEXT, BOLDON, 

"Please Select Optioni", PLflINTEXT, 0 


newOptio 

nTxt 1 

jnotare che ogni stringa e' a terminazione nulla 


.byte 

"new document", 0 



openOpti 

onTxt i 



.byte 

"existing document 

", 0 


quitOptionTxt 1 



.byte 

"to deskTop", 0 



createlcon: 

; tavola di definizione dell'icona CREATE 


.word 

createlconPic 

; indirizzo dei dati grafici del disegno dell'icona 

CREATE 

.byte 

0 

jcoordinata x, qui ignorata, dell'icona 


.byte 

0 

jcoordinata y, qui ignorata, dell'icona 


.byte 

SYSDBI-klIDTH 

jutilizza la larghezza standard delle icone 
jdi sistema (6 byte) 


.byte 

SYSDBI-HEIGHT 

jutilizza l'altezza standard delle icone 
jdi sistema (16 pixel) 


. word 

createlconServ 

Jpuntatore alla routine di servizio associata che i 

crea 



jil file e ritorna all'applicazione 


quitIcon 1 

jtavola di definizione dell'icona QUIT 


.word 

quitIconPic 

jindirizzo dei dati grafici del disegno dell'icona 

QUIT 

.byte 

0 

jcoordinata x, qui ignorata, dell'icona 


.byte 

0 

jcoordinata y, qui ignorata, dell'icona 


.byte 

SYSDBI-WIDTH 

jutilizza la larghezza standard delle icone 



jdi sistema (6 byte) 
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.byte 

SYSDBI-HEIGHT 

ut il izza l'altezza standard delle icone 
;di sistema (16 pi:x:el) 

.word 

■ruitlconServ 

; puntatore alla routine di servizio che termina 
; l'applicazione e cede il controllo a deskTop 

createlconServi 

; la,semplice routine di servizio per l'icona CREfiTE 

Ida 

#1 

; indica il numero dell'icona come se fosse stata attivata 
; 1'icona OK 

bne 

jrapIconServ 


■luitIconServi 


Ida 

#2 

,1 restituisce il va 1 ore per l'inona SUIT 

jmp Icori 

Berv ; 


sta 

sysDBDa t a 

.imemorizza il numero dell'icona prima 
.idi chiamare RstrFrmDialogue 

jmp 

RstrFrmDialogue 

; chiusura del BD 

crea tei 

conF'ic; 


96 byt 

e di dati grafici per 

l'icona che non riportiamo 


quitlconPic! 

96 byte di dati grafici per l'icona che non riportiamo 


Ecco come si presenta il BD che abbiamo appena definito: 


qeoì j file j edit j options j page j font j stylé^ 




LErrO CENUII 


Please Select Option: 
Cr68te| neut document 

I Open 1 existing document 

I Quii i to deskTop 
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L’esempio che segue mostra un BD per la selezione di file da disco. 

44 -- 

Esempio di box di dialogo: LoadBox 


Descrizione: Questo esempio, tratto da geoWrite, è una tavola di definizione di un BD 
visualizzato per aprire un documento già esistente. Se dai BD deil’esempio 
precedente l’utente seleziona l’icona OPEN, Tapplicazione visualizza ii BD 
per la scelta del file da aprire. 


Note: r7L contiene il tipo del file, secondo lo standard GEOS, che 

rappresenta la chiave di selezione dei file su disco 
r5 punta al buffer dove viene memorizzato il nome del file 

selezionato dall’utente 

r10 puntatore alla stringa che contiene il nome permanente 

associato al file. Questo nome rappN'esenta la seconda chiave 
di selezione dei file su disco. In questo caso “geoWrite”. Se il 
puntatore è azzerato il nome permanente non viene preso in 
considerazione. 


99 


LoadBox: 


.byte 

DEF-DB-POSIl 

;6D di dimensioni standard, con l'ombra visualizzata 
: impiegando la matrice grafica 1. 11 box di selezione dei file 
;<GetFile Box) si adatta molto bene a essere utilizzato 
jcon i BD di dimensioni standard 

.byte 

DBTXTSTR 

;visualizza la stringa "On disk:" 

.byte 

DBI-X-2 * 8 - 6 

joffset X in pixel per il testo <= 17t8-6 = 138) 

.byte 

TXT-LN-l-Y - 6 

joffset y 

.word 

curOiskString 

;puntatore al testo "current Disk:" 

.byte 

DBTXTSTR 

;stringa che contiene il nome del disco corrente 

.byte 

DBI-X-2 * 8 - 6 

joffset X in pixel per il testo <= 171:8-6 = 138) 

.byte 

TXT-LN-2-Y - 12 

joffset y 

.word 

diskNaine 

jpuntatore al buffer che già' deve contenere il nome del disco 

.byte 

DBGETFILES 

jil comando di selezione di file su disco 

.byte 

4 

joffset X in pixel dal lato sinistro del BD 

.byte 

4 

joffset y in pixel dal lato superiore del BD 
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.byte 

OPEN 

; visualizza l'icona OPEN 

.byte 

DBI_X-2 

joffset X standard per l'icona OPEN 

.byte 

24 

joffset y dal lato superiore del BD 

.byte 

CfiNCEL 

jvisualizza l'icona standard per l'icona CfìNCEL 

.byte 

DBI-X-2 

joffset X standard per l'icona CfiNCEL 

.byte 

72 

joffset y 

.byte 

DISK 

jicona DISK, quando sono connessi due drive la routine 
jdi servizio accede all'altro disk drive 

.byte 

DBI-X-2 

joffset X standard per l'icona DISK 

.byte 

48 

joffset y per 1'icona 

.byte 

0 

jterinine della tavola di definizione del BD 


curDiskStringi 

■byte PLflINTEXT, BOLDON, "On diski", PLflINTEXT, 0 jla stringa da visualizzare nel BD 


Le routine di gestione dei box di dialogo 

Nelle pagine successive sono riportate le descrizioni complete di tutte le routine di 
gestione dei BD che GEOS mette a disposizione delle applicazioni. 





Funzione: Visualizza un box di dialogo. 


Indirizzo: $C256 

Parametri: rOL restituito con il valore che indica quale selezione è stata operata 

dall’utente per chiudere il BD. Se l’utente ha selezionato un’icona di 
sistema, rOL riporta il numero che la identifica. DoDIgBox di fatto non 
esegue alcun ritorno all’applicazione. Essa salva lo stato del sistema, 
in modo che MainLoop possa dedicarsi temporaneamente al nuovo 
ambiente che si viene a creare con l’apertura del BD, visualizza il BD 
e cede il controllo a MainLoop che gestisce i nuovi eventi. Fra i vari 
eventi definiti per il BD, quelli che determinano condizioni di uscita 
utilizzano la routine RstrFrmDiaJogue per cedere H controllo all’applica¬ 
zione appena dopo la chiamata a DoCNgBox. Quindi i codici che 
chiamano DoDIgEÌox ottengono di nuovo il controllo solo dopo che il 
BD è stato richiuso. La chiamata viene effettuata con l’istruzione jsr 
DoDIgBox 

Restituisce: La routine non restituisce direttamente alcun parametro perché il ritorno, 
comandato dalla selezione dell’utente, passa attraverso la routine Rstr- 
FrmDialogue 

Distrugge: a, x, y, rO - r4, lo stack è preservato come tutte le variabili globali di sistema 

Sinossi: DoDIgBox visualizza un BD. Il codice che effettua la chiamata deve passare 

in rO l’indirizzo della tavola di definizione del BD. Tutte le variabili di sistema, 
cioè l’intero stato del sistema (disk, menu, icone, processi...) eccetto i registri 
rO - r4, vengono salvate per essere successivamente ripristinate da 
RstrFrmDialogue. Le routine realizzate per gestire il BD possono creare un 
nuovo ambiente di lavoro che comprende processi, menu e icone, senza 
rischiare di alterare lo stato del sistema precedente all’apertura del BD. I 
registri r5 - r10 possono essere utilizzati dall’applicazione per comunicare 
informazioni al BD prima che sia attivato. Nell’appendice B, tutte le 
locazioni di memoria racchiuse fra le label s_zp-global e e-zp-globai 
indicano le aree di memoria che vengono salvate durante l’attivazione dei BD 
e degli accessori da scrivania (Desk Accessory). 






Funzione: Effettua la chiusura di un BD ed il ritorno ai codici dell’applicazione. 

Indirizzo: $C2BF 


Chiamata da: I BD possono essere chiusi fondamentalmente in due modi. Se l'utente 
seleziona un’icona di sistema o attiva un comando di chiusura del BD, viene 
automaticamente eseguita RstrFrmDialogue. Oltre alla chiusura standard 
prevista dal sistema, il BD può essere disattivato anche attraverso routine 
realizzate per gestirlo in maniera non convenzionale. In questi casi i codici 
dell’applicazione devono chiamare la routine RstrFrmDialogue per chiudere 
definitivamente il BD e ripristinare lo stato precedente del sistema. Quindi, 
a prescindere dal fatto che la disattivazione sia standard o realizzata 
dall’applicazione, la chiusura del BD avviene sempre attraverso la routine 
RstrFrmDialogue 

Parametri: sysDBData questa variabile di sistema deve contenere l’identificatore della 

selezione che ha causato la chiusura del BD. Se la disattivazio¬ 
ne del BD è avvenuta attraverso la selezione di un’icona, 
sysDBData deve contenere il numero di questa icona in modo 
che RstrFrmDialogue lo restituisca in rOL. Questa informazione 
consente al codice che ha richiesto l’apertura del BD, d’iden¬ 
tificare la selezione operata dall’utente 

Restituisce: rOL questo registro viene aggiornato con il contenuto della variabile 

globale sysDBData. Normalmente restituisce l’identificatore 
della selezione che ha causato la chiusura del BD 
Altro dal momento che i BD possono essere gestiti anche da 
routine deH’applicazione, può accadere che esse restituisca¬ 
no parametri specifici a seconda delle operazioni che hanno 
compiuto 

System all’apertura del BD, DoDIgBox salva l’intero stato del sistema, 
quindi RstrFrmDialogue lo deve ripristinare per ricreare la 
situazione precedente all’apertura del BD. Perciò, a eccezio¬ 
ne degli pseudoregistri, lo stato del sistema memorizzato su 
RAM (menu, icone, buffer, ecc) viene integralmente ripristina¬ 
to 

a, X, y, rOH - r14 


Distrugge: 
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Sinossi: 


Questa routine viene chiamata per chiudere il BD. Può essere eseguita sia 
dai codici di gestione del BD presenti nel Kernel di GEOS, sia dalle routine 
(se presenti) previste daH’apfrficazione per operare una gestione non 
standard del BD. Per il codice che ha ricWesto l’apertura del BD, la chiamata 
di questa routine è completamente trasparente, nel senso che il codice 
esegue l’istruzione jsr DoD^ox e ottiene nuovamente il controllo 
all’istruzione seguente, una volta che il BD è stato chiuso. Per esempio, il 
codice dell’applicaztone richiede l’apertura del BD. Allora GEOS salva lo 
stato del sistema e tratta il BD come un nuovo mibiente di lavoro entro il 
quale, come avviene di solito, una tavola di definizione indica tutti gli eventi 
che il Kernel deve gestire (menu, icone, procèssi...). Alcuni eventi sono 
standard e non richiedono alcuna routine di servizio da parte dell’applicazio¬ 
ne, per essere eseguiti; una volta selezionati gii eventi, le routine di sistema 
che li gestiscono memorizzano in sysDBData l’identificatore dell’evento 
standard attivato e chiamano RstrFrmDialogue per chiudere il BD e 
ripristinare io stato del sistema come se niente fosse accaduto. Altri eventi 
invece possono essere realizzi c^’eq^plicazione per sodcttsfare particolari 
esigenze, e non devono necessanamer^ c^kxiere il A essi sono 
associate le appropriate rou^ di servizb messe a cHsposiziof^ daU’appiica- 
zione. Le routine di servizb che, se attivate, chbckxìo il BD devono 
aggiornare sysDBData con l’identificatore dell’evento e devono contenere la 
chiamata alla routine RstrFrmDialogue. Quando viene eseguita RstrFrmDia¬ 
logue, lo stato del sistema viene interamente ripristinato, a eccezione degli 
pseudoregistri, e in rOL è riportato l’identificatore deH’evento che ha causato 
la chiusura del BD. 





IL SISTEMA DI 
GESTIONE DEI 



GEOS adotta un sistema di organizzazione dei file su disco che ha molto in comune 
con il DOS residente nel 1541, ma aggiunge alla struttura di base alcune caratteristiche 
proprie. Vediamo i fattori grazie ai quali abbiamo potuto rendere più efficiente la 
gestione dei file e l'accesso al disco. 

La struttura originale del C-64 non era stata realizzata per l’impiego di una memoria 
di massa su disco. In origine, non si pensava affatto che il disk drive del C-64 avrebbe 
avuto una così grande diffusione. La conseguente lentezza di accesso al disco si è 
dimostrata col tempo uno dei limiti più evidenti della macchina. A causa di questa 
lentezza, le applicazioni create per il C-64 di solito leggono i dati dal disco aU’inizio 
dell'esecuzione e durante l’elaborazione li salvano il meno possibile, rimandando 
l’aggiornamento dei file a un secondo momento. Se durante l’esecuzione dell’applica¬ 
zione si rende necessario accedere al disco, l’utente può tranquillamente concedersi 
un caffè, tanta è la lentezza che caratterizza l’accesso. Per ovviare a questo problema, 
GEOS mette a disposizione un codice turbo (diskTurbo) che accresce notevolmente la 
velocità durante lo scambio dei dati fra il C-64 e il disk drive, diminuendo di 
conseguenza i tempi di accesso. Con l’introduzione di questa routine, l’accesso al disco 
diventa più pratico e più veloce. Lo scaimbio di dati può interessare anche solo parti 
di file e può avvenire tranquillamente durante l’esecuzione delle applicazioni in 
quanto, in ambiente GEOS, il tempo necessario per comunicare con il disco è minimo. 

GEOS mette a disposizione due strutture fondamentali per organizzare i file su disco. 
La prima è abbastanza simile alla struttura convenzionale dei file adottata dal C-64 e 
viene chiamata struttura SEQUENTIAL(t). Essa prevede che i file siano organizzati e 


(t) Il termine SEQUENTIAL, utilizzato per identificare una delle due strutture possibili previste da GEOS, 
identifica qualsiasi tipo di file GEOS con una struttura non VLIR, e non dev’essere confuso con il tipo SEQ 
disponibile nel DOS del 1541. Per fare un esempio, i tipi USR, PRG e SEQ utilizzati dal C-64 rientrano tutti 
nella struttura SEQUENTIAL. 
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gestiti secondo una lista di blocchi allocati su disco, che raccolgono sequenzialmente 
i dati del file. Prima di proseguire è bene precisare il significato della parola “blocco". 
Un blocco per il C-64, a prescindere dalla sua collocazione (memoria interna o disco), 
rappresenta un gruppo di dati significativi composto da 256 byte, numerati dal byte 
0 al byte 255 ($FF). 

Dal momento che blocco e settore, su disco, barino la stessa dimensione, nel corso 
del libro adottiamo indifferentemente entrambi i termini. Volendo essere precisi, il 
“settore" è uno spazio fisico sul disco, mentre il “blocco” è un gruppo di dati che viene 
memorizzato nel settore, e lo occupa completaiiientf. Utilizzeremo comunque i due 
termini, senza distinzione, per indicare un gruppo di dati da 256 byte memorizzato su 
disco. La parola blocco, dal momento che individua im gruppo di dati, si adatta 
perfettamente a rappresentare anche i dati presenti in memoria, che all’occorrenza 
possono essere suddivisi in gruppi di 256 byte (pagine). In quest’ultimo caso il termine 
settore sarebbe improprio, e qpihidi adotteremo unicamente la parola blocco. 
Ritornando alla struttura SEQUENTIAL, i primi due byte di ogni settore contengono 
Tindirizzo su disco del succéssivo settore concatenato. Questo indirizzo è indicato dal 
“numero di traccia' nel primo byte, e dal “numero di settore", nel secondo byte; quando 
ci riferiremo a questi due byte, li identificheremo con il termine “indirizzo T/S”. 
L’ultimo blocco di un file su disco non segue questa regola. Dal momento che non ci 
sono blocchi successivi, e rultimo potrebbe non essere completamente riempito, si 
rende necessario indicare quanti byte dell’ultimo blocco sono da considerate 
significativi per il file di cui fa parte. Il primo byte, in questo caso, ha valore 0 (e questo 
identifica l’ultimo settore), e il secondo contiene un indice che punta all’ultimo byte 
significativo del file. 

La seconda struttura di organizzazione dei file su disco è una novità per gli utenti 
del C-64. È chiamata struttura a Record Indicizzati di Lunghezza Variabile (Variable 
Lenght Indexed Record), che per brevità si riduce a “struttura VLIR”. Per l’importanza 
che riveste, abbiamo dedicato un intero capitolo a questa nuova struttura da noi ideata 
e realizzata. In entrambe le strutture, GEOS alloca per ogni file un blocco addizionale 
che diventa parte integrante dei file. Si tratta dei blocco File Header, e contiene 
importanti informazioni che GEOS mette a disposizione di tutti i file, come per esempio 
i dati grafici dell’icona che individua il file sullo schermo e altri parametri che 
analizzeremo nelle prossime pagine. 

Per riuscire a capire in modo davvero completo il sistema adottato da GEOS per i file, 
è necessario avere un’ottima conoscenza della struttura su cui si basa il sistema, cioè 
quella realizzata dalla Commodore. Per i lettori che non avessero mai approfondito 
questo argomento sono presenti in commercio diverse pubblicazioni dedicate al 
sistema dei file adottato per il C-64. 

Questo capitolo è diviso in due sezioni principali. La prima è vm veloce ripasso delle 
nozioni necessarie per intraprendere una lettura agevole del resto del capitolo. La 
seconda illustra nei dettagli il sistema dei file in ambiente GEOS e introduce le varie 
routine presenti nel Kernel per operare con il drive. Queste routine si possono 




IL SISTEMA DI GESTIONE DEI FILE 


259 


raggruppare in tre livelli, ciascuno contraddistinto da un crescente grado di 
completezza. Ogni livello è poi dettagliatamente illustrato nei capitoli successivi, un 
capitolo per ogni livello. Al livello più alto vengono descritte le routine più complete 
dal punto di vista operativo, in grado, di compiere autonomamente una sequenza di 
operazioni correlate. Sono le prime routine con cui il programmatore deve 
familiarizzarsi. Soddisfano le esigenze più comuni con una sola chiamata da parte 
dell’applicazione, ma essendo estremamente articolate è improbabile che possano 
soddisfare le richieste che escono dalla norma. A questo scopo esistono due livelli 
inferiori di routine che compiono operazioni sempre più semplici, ma che opportuna¬ 
mente combinate possono generare nuove funzioni di notevole complessità. Il compito 
del programmatore diventa più complesso, in questo caso, ma la flessibilità offerta 
dalle diverse combinazioni dovrebbe essere sufficiente a soddirfare qualunque 
esigenza. Dopo questi tre capitoli dedicati ai tre livelli di routine disponibili su GEOS, 
segue il capitolo riservato all’analisi della struttura VLIR di GEOS. 


Le nozioni di base 

Un disco in formato C-64 è suddiviso in 35 tracce. Le tracce sono fisicamente 
disposte in cerchi concentrici, e ogni anello circolare contiene più tracce. La traccia 1 
si trova sul bordo del disco, la traccia 35 al centro. Ogni traccia è ulteriormente 
suddivisa in settori, chiamati anche blocchi. Le tracce situate lungo il bordo esterno 
del disco sono di maggiori dimerisioni, rispetto a quelle vicine al centro, e quindi 
contengono un numero maggiore di settori. La tavola che segue elenca i settori per 
ogni gruppo di tracce e il numero di settori in esse contenuti. 


Distribuzione dei settori nelle tracce 


Numero di traccia 

Numerazione dei settori 

Numero di settori per traccia 

da 1 a 17 

da 0 a 20 

21 

da 18 a 24 

da 0 a 18 

19 

da 25 a 38 

da 0 a 17 

18 

da 31 a 35 

da 0 a 16 

17 


La traccia 18 contiene la directory del disco. In essa sono presenti le informazioni 
associate ai file presenti su disco. Il settore 0 di questa traccia (blocco d’intestazione 
della directory, o Directory Header Block) contiene la mappa dei blocchi liberi (BAM) 
e l’intestazione della directory (Directory Header). La BAM è un insieme di bit, a 
ognuno dei quali è associato un settore. I bit corrispondenti a settori del disco allocati 
per contenere dati significativi sono impostati a 1, mentre quelli associati a settori 
liberi sono impostati a 0. Come per i file normali, anche la directory è una 
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concatenazione di settori, e quindi il Directory Header Block contiene l’indirizzo T/S 
del primo blocco dati della directory (Directory Block). L’organizzazione della BAM non 
viene assolutamente alterata da GEOS. 

La Directory Header è un insieme di dati presente all’interno del Directory Header 
Block che contiene il nome del disco (una word chiamata Disk ID che costituisce 
l’identificatore del disco) e tre nuovi elementi introdotti da GEOS: un identificatore 
GEOS (GEOS ID) contenuto in una stringa di caratteri, l’indirizzo T/S del blocco 
addizionale associato al disco (Off Page Directory Block) che chiameremo per brevità 
Off Page del disco, e un hyte che identifica il livello di protezione del disco. Queste tre 
informazioni introdotte da GEOS occupano uno spazio, nel Directory Header Block 
della directory, che normalmente non viene utilizzato. 

La presenza della stringa GEOS ID indica che il disco è in formato GEOS, e contiene 
la versione del formato, che può essere importante per la compatibilità fra l’attuale 
versione di GEOS e quelle future. Questa stringa non dev’essere confusa con la GEOS 
ID memorizzata nel Kernel a $C000, che identifica non il formato delle strutture dei dati 
su disco ma la versione del Kernel di GEOS, come si è visto nel capitolo 1. 

Il blocco Off Page associato al disco è un ampliamento al sistema dei file introdotto 
da GEOS e ha la stessa struttura dei blocchi che contengono la directory. Un blocco 
della directory contiene otto File Entry. Ogni file presente sul disco è individuato da 
un File Entry che gU assegna ima serie di informazioni. In deskTop, quando si sposta 
l’icona di un file dal notes bianco alla scrivania (il bordo circostante), il File Entry del 
file viene cancellato dal blocco della directory che lo conteneva e trasferito nel blocco 
Off Page, che rappresenta la scrivania. Come ogni blocco della directory. Off Page non 
può contenere più di otto file. In memoria GEOS mantiene anche un buffer che 
all’occonenza può raccogliere le informazioni relative a tutti i file presenti sulla 
scrivania. La scrivania, e quindi il blocco Off Page che la realizza su disco, è stata ideata 
e creata per consentire la copia dei file fra due dischi nel caso che il sistema sia dotato 
di un solo drive. Quando deskTop visualizza la directory a pagine di un nuovo disco, 
le icone che in precedenza erano state situate sulla scrivania non vengono cancellate 
dallo schermo. Se l’utente sposta una di queste icone in una pagina della nuova 
directory, deskTop inizia la procedura di copia del file dal disco precedente al disco 
nuovo, segnalando all’utente le opportune operazioni da compiere. 

Il byte che identifica il livello di protezione del disco è memorizzato alla posizione 
189 del Directory Header Block. Come sempre, nell’appendice si troverà la costante 
associata a questo byte, OFF-G-DTYPE “ 189. Ricordiamo che la numerazione dei byte 
all’interno cfi un blocco inizia da 0. Di solito il byte di protezione è impostato a 0, per 
indicare che il disco non è soggetto ad alcun livello di protezione. Se invece contiene 
il codice ASCII della lettera P, il disco è soggetto al hvello di protezione associato ai 
Master Disk. GEOS VI.3 e le applicazioni deskTop successive non permettono 
l’esecuzione di molte operazioni sui dischi Master Disk. Non possono essere formattati 
o copiati, per esempio, e i file in essi presenti non possono essere cancellati dal disco 
con la procedura normale (icona del file spostata sul cestino). I file possono comunque 
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essere spostati sulla scrivania e cancellati da lì. Con questo livello di protezione gli 
utenti del sistema operativo GEOS non rischiano di formattare accidentalmente un 
Master Disk, o di distruggere i dati che questo contiene. Se il byte individuato da 
OFF-GS-DTYPE contiene invece il codice ASCII della lettera B, il disco è un Boot Disk, 
cioè un disco sul quale risiede l’intero Kernel e i programmi per attivarlo. 

Ecco la tavola che illustra nei dettagli il formato del Directory Header Block. 
Contiene la BAM e la Directory Header. 


Formato della BAM e della Directory Header 


Byte 

Contenuto 

Descrizione 

0 

18 


Traccia del primo blocco della directory, 




e' sempre 18 

1 

1 


Settore del primo blocco della directory, 




e' sempre 1 

2 

65 


Codice ASCII di fl indicante il formato 




del disco 1541 

3 



Ignorato 

BAM Traccia 1 




4 

21 


Numero di settori in traccia 1 

5 



Bit dei settori 0-7 

6 



Bit dei settori 8-16 

7 



Bit dei settori 17-20 

BAM Traccia 2 




8 

21 


Numero di settori in traccia 2 

9 



Bit dei settori 0-7 

10 



Bit dei settori 8-16 

11 



Bit dei settori 17-20 



, BfìM per 

le tracce dalla 3 alla 34 ,,. 

BAM Traccia 35 




140 

17 


Numero di settori in traccia 35 

141 



Bit dei settori 8-7 

142 



Bit dei settori 8-16 

143 



Bit non usati per questa traccia 




SEGUE 
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Directory Header 


144 - 

159 


None del discoj conpletato con il carattere 




fìSCII ifle 

160 - 

161 

$R0 

Spazi + tasto SHIFT (fiSCll $fl8) 

162 - 

163 


Nord Disk ID 

164 


$Re 

Spazio + tasto SHIFT (ASCII tW) 

165 - 

166 

«2, f41 

Codici ASCII 2R, Versione Dos e Formato Disco 

167 - 

170 

$Re 

Spazi + tasto SHIFT (ASCII $fl0) 

171 - 

172 


Indirizzo T/S del blocco Off Page della directory 

173 - 

188 


Stringa GEOS IDi "GEOS format VI,2" 

189 


0/'P'/'B' 

P indica il livello protezione Master Disk, 8 




indica i Boot Disk 

190 - 

255 

0 

Rttualnente inutilizzati 


La tavola che segue mostra il formato di un blocco della directory (Directory Block), 
diverso dal blocco di intestazione. La struttura di base di un Directory Block resta 
inalterata in ambiente GEOS. 


Struttura di un Directory Block 


I blocchi della directory possono apparire in traccia 18 nei settori 1-19 
Numero byte Descrizione 


0 - 1 

Indirizzo T/S del successivo Directory Block 

2 - 31 

File Entry 1 

32 - 33 

Inutilizzati 

34 - 63 

File Entry 2 

64 ■ 65 

Inutilizzati 

66 - 95 

File Entry 3 

96 - 97 

Inutilizzati 

98 - 127 

File Entry 4 

128 - 129 

Inutilizzati 

130 - 159 

File Entry 5 


SEGUE 
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160 - 161 

Inutilizzati 

162 ^ 191 

File Entry 6 

192 - 193 

Inutilizzati 

194 - 223 

File Entry 7 

224 - 225 

Inutilizzati 

226 - 255 

File Entry 8 


Nel formato originale del C-64 i File Entry contengono molti byte inutilizzati. GEOS 
li impiega per aumentare la quantità delle informazioni associate ai singolo file. 
Analizziamo la struttura di un File Entry. Il byte 0, telati^ all'niizio del File Entry 
indica il tipo del file secondo lo standard C-64. Di solito, i file in ambiente GEOS 
appartengono al tipo USR del C-64. Se la struttura del file non è VLIR, i byte 1 e 2 
contengono l’indirizzo T/S del primo blocco di dati. Se invéce la sua struttura è VLIR 
i byte 1 e 2 contengono l’indirizzo T/S del blocco indice del file (Index Tabie). I byte 
dal 3 al 18 contengono il nome del file. Se il nome contiene meno di 16 caratteri, i byte 
che restano devono contenere il carattere ASCII $A0. I byte 19 e 20 contengono 
l’indirizzo T/S del nuovo blocco che GEOS associa a ogni file; il blocco File Header. 
L’importanza di questo blocco aggiuntivo sarà illustrata più avanti. I byte 21 e 22 
identificano il tipo di struttura e il tipo del file secondo il formato GEOS. Il byte 21 
indica con quale struttura è organizzato il file su disco. Con il valore 0 si indica la 
struttura SEQUENTIAL e con il valore 1 la struttura VLIR. Il tipo del file indica a quali 
usi è destinato. DATA, BASIC, APPLICATION sono solo alcuni dei possibili tipi. 11 tipo 
SYSTEM-BOOT dovrebbe essere assegnato solo ai file GEOS Boot e Kernel. 11 tipo 
TEMPORARY viene assegnato ai file temporanei (swap file). Tutti i file di tipo 
TEMPORARY presenti su qualsiasi disco sono automaticamente cancellati da deskTop 
quando vi accede per leggere la directory. deskTop assume che siano presenti su disco 
per motivi accidentali. I file temporanei sono creati dalle applicazioni per usi interni 
e non hanno ragione di esistere se l’applicazione ha terminato il suo svolgimento. Non 
sempre però l’applicazione riesce a effettuare la cancellazione, per esempio quando 
viene a mancare improvvisamente l’energia elettrica, e in questi casi è il sistema che 
deve provvedere. Quando le applicazioni devono creare alcuni file per uso interno, 
devono utiUzzare il tipo TEMPORARY e iniziare il nome del file con il carattere di 
controllo PLAINTEXT. Ecco un esempio; 

swapName! .byte PLAINTEXT, "File Tempora.",0 

In questo modo il nome del file viene visualizzato in deskTop con lo stile PLAINTEXT 
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e diventa impossibile che un altro file con lo stesso-nome sia sostituito dal file 
temporaneo. I file di tipo AUTO-EXEC vengono automaticamente mandati in 
esecuzione dal Kernel di GEOS VI.3, e successivi, durante la fase d'inizializzazione del 
sistema. Il Kernel, prima di procedere al caricamento di deskTop, scorre la directory 
alla ricerca del primo file di tipo AUTO-EXEC, e ^ lo trova lo manda in esecuzione. 
Questo può effettuare variazioni nel sistema di default (configurazione, colori, 
espansioni...), e deve terminare con l’isttuzione jmp EnterDeskTop. Infine troviamo i 
byte dal 23 al 27 che contengono l’ora e la data deU’ultima modifica al file. Così i file 
possiedono anche l’indicazione cronologica dell’ultima modifica. 


Struttura del File Entry 


Byte Descrizione 

0 Tipo file C-64i 0=DELetecl, l=SEQuential, 2=PRoGram, 3»USeR, 

4=RELative. Il bit 6 indica se il file e' protetto 
1-2 T/S del primo blocco di dati del file. Se il file e' a struttura VLIR, 

l'indirizzo T/S indica la Index Table 

3-18 16 caratteri per il nome, completato eventualmente con il carattere 

ottenuto tramite il tasto SHIFT -F Spazio (ASCII IRA) 

19 - 20 T/S del blocco File Header (nuova struttura) 

21 Struttura GEOS del file; 0-SEQUENTIRL, 1-VLIR 

22 Tipo GEOS del file (vedere la tavola successiva) 

23 Data: anno dell'ultima modifica; solo le ultime due cifre 

24 Data: mese dell'ultima modifica (1 - 12) 

25 Data: giorno dell'ultima modifica (1 - 31) 

26 Data: ora dell'ultima modifica (0 - 23) 

27 Data: minuto dell'ultima modifica (0 - 59) 

28 - 29 Word che contiene il numero di settori occupati dal file 
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Tipi di file disponibili con GEOS 


Codice 

Nome associato al tipo 

0 

NOT-GEOS 

1 

BASIC 

2 

RSSEMBLY 

3 

DATA 

4 

SYSTEM 

5 

DESK-ACC 

6 

APPLICATION 

7 

APPL-DATA 

8 

FONT 

9 

PRINTER 

10 

INPUT-DEVICE 

il 

DISK-DEVICE 

12 

SYSTEM-BOOT 

13 

TEMPORARY 

14 

AUTO-EXEC (compatibile solo con versioni di 

GEOS superiori alla 1.2) 


11 blocco File Header 

Il blocco addizionale File Header che GEOS assegna a tutti i file rappresenta una 
novità per gli utenti Commodore. È stato creato per contenere i dati grafici che 
definiscono il disegno dell'icona e altre informazioni utili per GEOS e per l’utente. La 
sua ubicazione sul disco viene individuata dall’indirizzo T/S memorizzato nei byte 19 
e 20 del File Entry del file. Il DOS del drive 1541 memorizza in questi due byte di un 
File Entry l’indirizzo T/S del side sector di gestione dei file di tipo RELative. Dal 
momento che GEOS non riconosce questo tipo di struttura, i byte 19 e 20 possono 
essere impiegati per puntare il blocco File Header associato al file. 

I primi due byte di un settore di solito individuano l’indirizzo T/S del successivo 
settore concatenato, oppure, nel caso dell’ultimo settore, contengono il numero di byte 
significativi del settore stesso. Dal momento che il blocco File Header non è 
concatenato a nessun altro file, il byte 0 contiene il valore 0 e il byte 1 il valore $FF. 
In questo modo si indica che il blocco File Header costituisce un blocco extra del file 
e non è parte di alcuna concatenazione. 

La tavola riportata nella pagina successiva analizza uno per uno i byte presenti nel 
blocco File Header. 
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Struttura del blocco File Header 


Byte 

Contenuto 

Descrizione 

0 - 1 

$00, $FF 

Il blocco File Header non e' 

concatenato a nessun altro blocco 

2 

3 

Larghezza dell'icona in byte, sempre 3 

3 

21 

filtezza dell'icona in linee di scansione, 
sempre 21 

4 

$80 + 63 

Tipo dei dati in bit-map per il disegno dell'icona, 
Se il bit 7 e' impostato a 1, il valore contenuto 
nei restanti 7 bit indica il numero di singoli 
byte che seguonoi sempre 63 

5 - 67 

$FF, $FF, $FF 

Inizio dei 63 byte che definiscono il 
disegno del 1'icona 


$FF, $FF, $FF 

Fine dei dati che definiscono il disegno 
dell'icona 

68 

$80 + USR 

Tipo C-64 del file utilizzato quando il file e' 
salvato da GEOS. PRG=1, SEQ=2, USR=3, REL=4, 

Bit 6=1 indica che il file e' protetto 

in scrittura 

65 

6 

Tipo GEOS del file (vedere la tavola precedente) 

70 

0 

Struttura GEOS del file: 0=SEQUENTIflL, 1=VLIR 

71 - 72 

FileStart 

Indirizzo in memoria dove il file inizia a 

essere memorizzato 

73 ■ 74 

FileEnd 

Indirizzo in memoria dell'ultimo byte del file 
memorizzato 

75 ■ 76 

InitProg 

Indirizzo della routine di inizializzazione da 
eseguire dopo il caricamento 

77 - 96 

PeriKianentString 

Solo i primi 16 dei 20 byte sono utilizzabili. 

Byte 0 - 11 nome permanente completato con 
spazi. Byte 12 - 15 stringa versione, es; VI.3. 

Byte 16 - 20 azzerati 

97 - 116 

ParentDisk 

Se il file contiene i dati di un'applicazione, 
sono disponibili 20 byte per il nome del disco 
che contiene l'applicazione. 


Nome autore 

Se il file e' un'applicazione, sono disponibili 28 
byte per il nome dell'autore 

SEGUE 
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Byte 

117 - 136 


137 - 159 
160 - 255 


Contenuto Descrizione 


Parentflpplication 


Application 

Info 


Se il file contiene i dati di un'applicazione, 
sono disponibili 20 byte per il nome 
dell'applicazione, Byte 0 - 11 nome 
dell'applicazione completato con spazi. 

Byte 12 - 15 stringa versione, es: VI,3, 

Byte 16 - 20 azzerato 
23 byte disponibili per le applicazioni 
Questo spazio viene impiegato dall'opzione Info 
del menu file presente in deskTop per 
memorizzare i commenti al file digitati 
dall'utente. Il testo dev'essere una stringa 
a terminazione nulla. Se non e' presente alcun 
testo il primo byte <il byte in posizione 160) 
dev'essere azzerato 


I byte 2 e 3 contengono la larghezza e l’altezza del disegno che rappresenta l’icona. 
I dati che generano il disegno sono situati dal byte 4 al byte 67. Le icone dei file hanno 
sempre la stessa dimensione: 3 byte di larghezza e 21 linee di scansione in altezza. Le 
dimensioni dell’icona precedono i dati del disegno in quanto la routine interna di 
visualizzazione delle icone è generalmente in grado di visualizzare icone di qualunque 
dimensione, e prevede che le dimensioni dell’icona precedano i dati del disegno. Lo 
spazio dal byte 4 al byte 67 contiene il disegno dell’icona memorizzato in formato 
compattato Bit-Map. 11 byte 4 è il byte di formato che identifica il tipo di compattazione. 
GEOS prevede tre formati differenti di compattazione. Il secondo formato, come già 
illustrato nel capitolo dedicato alla grafica, indica un gruppo di dati Bit-Map espansi 
dopo la compattazione. Quando si adotta questo formato, il byte 4 dev’essere un 
numero compreso fra 128 e 220. Il numero di byte interessati dal formato di 
compattazione si ottiene sottraendo 128 al byte di formato. Dal momento che sottrarre 
128 significa azzerare il bit 7, i bit rimanenti indicano il numero di byte che seguono. 
Questo numero dev’essere compreso fra 1 e 92. Un’icona delle dimensioni specificate 
è composta da 63 byte, e quindi il byte formato si ottiene con l’operazione $80 + 63. 

I tre bit meno significativi del byte 68 indicano il tipo del file tra quelli riconosciuti 
dal 1541 (PRG, SEQ, USR, DEL). Il byte 69 specifica il tipo del file in ambiente GEGS. 
Attualmente GEQS mette a disposizione 15 differenti tipi di file. È possibile che in 
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futuro ne vengano resi disponibili altri, ma riguarderanno con ogni probabilità file di 
dati particolari che in questa sede raggrupperemo nel tipo generico APPL_DATA. Il 
byte 70 indica la struttura GEOS adottata per organizzare il file su disco. Abbiamo già 
accennato ai due tipi di struttura disponibili, VLIR e SEQUENTIAL; è opportuno 
ricordare ancora che la struttura SEQUENTIAL in ambiente GEOS individua 
esclusivamente tutti i file composti da un concatenamento di blocchi sequenziale, e 
non dev'essere confusa con il tipo SEQ caratteristico del disk drive 1541. 

I byte 71 e 72 costituiscono una word che individua l’indirizzo in memoria al quale 
GEOS deve iniziare a memorizzare il file prelevato da disco. Di solito GEOS accede a 
questa informazione per caricare un file da disco in memoria, ma, come vedremo, può 
anche utilizzare un indirizzo alternativo se l’applicazione lo richiede espressamente. 
Questa seconda procedura si rende utile quando l’applicazione deve caricare un file 
dati da disco e lo deve allocare in memoria a un particolare indirizzo, che può anche 
essere diverso di volta in volta. I byte 73 e 74 costituiscono una word che individua 
l’indirizzo dell’ultimo byte del file in memoria, ovvero la fine del file. Questa è 
un’informazione utile per diversi scopi. Quando GEOS deve salvare un file su disco, per 
prima cosa calcola la lunghezza del file per accertarsi che il disco abbia lo spazio 
sufficiente per contenerlo; l’applicazione deve preoccuparsi di aggiornare la word che 
contiene l’indirizzo di fine file nel caso che la lunghezza del file in memoria venga 
alterata. Quando GEOS deve caricare in memoria un file di tipo ASSEMBLY o BASIC, 
il calcolo della lunghezza diventa fondamentale. Se il file non si sovrappone al Kernel, 
GEOS è in grado di caricarlo utilizzando il turbo, riducendo così considerevolmente il 
tempo di “loading" necessario. Se invece il file è talmente lungo da sovrapporsi ai 
codici del Kernel, GEOS lo carica utilizzando le normali (e lente) routine messe a 
disposizione dal Kernel del C-64. 

1 file eseguibili sono quelli di tipo BASIC, ASSEMBLY, APPLICATION, DESK_ACC 
e AUTO-EXEC. Dopo che il file è stato caricato in memoria, GEOS accede alla word 
individuata dai byte 75 e 76 per sapere qual è l’indirizzo della routine a cui cedere il 
controllo per avviare l’applicazione. Normalmente si tratta dell’indirizzo di caricamen¬ 
to specificato dai byte 71 e 72, in quanto di solito la routine d’inizializzazione è la prima 
dell’applicazione (ma non è certo una regola). 

I successivi 20 byte del blocco memorizzano la stringa che indica il nome 
permanente del file (PermanentName). Sebbene siano allocati 20 byte per questa 
informazione, gli ultimi 4 dovrebbero essere sempre a zero. La lunghezza massima di 
16 caratteri imposta a questa stringa è necessaria per mantenere la compatibilità con 
la lunghezza dei nomi di file. Dei 16 byte significativi, i byte 0-11 sono effettivamente 
impiegati per il nome, eventualmente completato con alcuni speizi. Questo nome 
caratterizza tutti i file dati generati dalla stessa applicazione. Quando l’applicazione 
scorre la directory di un disco per raggruppare tutti i file da essa generati, accede al 
PermanentName di ogni file di tipo APPL-DATA e lo confronta con il nome 
permanente assegnato ai suoi file dati. Oltre al nome permanente, è importante anche 
sapere qual è il formato usato per memorizzare i dati nel file. Nei byte 12-15 è indicata 
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appunto la particolare versione di questo formato. Per una nostra convenzione, 
l’identificatore è rappresentato da una V maiuscola seguita da due numeri separati da 
un punto: Vl.O. Il primo dei due numeri è il più significativo. Si noti che la versione 
del fonnato dei file dati non ha alcuna relazione con la versione dell’applicazione. 

Per un file di dati è assolutamente necessario un nome permanente di.qualche tipo, 
grazie al quale l’utente sia libero di dare al file un nome significativo e in seguito 
cambiarlo. Per fare un esempio, geoWrite dev’essere capace di riconoscere che un file 
di dati versione 1.0 è effettivamente un file di dati geoWrite Vl.O, nonostante il nome 
assegnatogli. 

A seguito dei 20 byte allocati per il nome permanente si trovano altre due stringhe 
da 20 byte che possono essere utilizzate dalle applicazioni in vari modi. Come accade 
per il nome permanente, anche queste due stringhe contengono un nome nei byte 0-11 
e la versione nei quattro successivi. Gli ultimi quattro byte non vengono utilizzati. La 
prima delle due stringhe, allocata nei byte 97-112, è denominata ParentDisk, e 
contiene il nome del disco sul quale si trova l’applicazione che ha generato il file. Se 
però il file non è un file dati, ma un’applicazione, in questa stringa può apparire il nome 
del suo autore. Attualmente il nome ParentDisk non viene impiegato dalle applicazioni 
GEOS compatibili. 

Quando l’utente preme due volte in rapida successione il pulsante del mouse in 
corrispondenza dell’icona di un file dati, deskTop accede alla stringa ParentApplica- 
tion, allocata nei byte 117-132, per sapere qual è il nome dell'applicazione che ha 
generato il file. Se non trova l’applicazione sullo stesso disco, visualizza un messaggio 
all’utente nel quale richiede che sia inserito il disco opportuno, come per esempio: 
“Please insert a disk with geoWrite". Quando GEOS scorre la directory di un disco alla 
ricerca dell’applicazione il cui nome è specificato nella stringa ParentApplication, 
confronta i nomi dei file solo per i primi 12 byte, e ignora l’informazione sulla versione 
contenuta nei byte successivi. Spetta all’utente controllare che la versione sia quella 
che GEOS si aspetta. Vi è la tacita convenzione che le applicazioni devono essere in 
grado di gestire tutti i file dati generati da versioni precedenti della stessa 
applicazione. Tutti i programmatori dovrebbero tenerne conto, durante la modifica 
delle loro applicazioni. 

Quando l’applicazione viene caricata ed eseguita, deve accedere alla stringa del 
PermanentName assegnata al file dati che sta analizzando. Di norma questa stringa 
è la stessa utilizzata per il nome ParentApplication, anche se il numero della versione 
può essere diverso. Se per esempio l’utente seleziona da deskTop un file dati creato 
con l’applicazione geoWrite VI.2 e inserisce un disco contenente l’applicazione 
geoWrite V2.0, deskTop, che non confronta i numeri di versione, carica ed esegue 
l’applicazione geoWrite V2.0. È compito dell’applicazione, di geoWrite, accedere al 
nome permanente del file dati e decidere se si rende necessaria la conversione dei dati 
nel formato adottato dalla nuova versione. Se le due versioni 1.2 e 2.0 presentano 
differenze sostanziali, geoWrite V2.0 dev'essere in grado di effettuare le opportune 
conversioni per essere compatibile con i dati creati dalla versione precedente. 




270 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


Di solito la versione di un programma “cresce" più rapidamente della versione del 
formato dei dati che esso impiega; questo accade perché di un programma si realizzano 
nuove versioni anche solo per correggere tutti gli errori riscontrati. I numeri di versione 
che individuano i formati dei dati tendono a seguire aggiornamenti più discontinui di 
quelli delle applicazioni. Per fare un esempio, una particolare applicazione viene 
introdotta sul mercato come versione 1.0.1 dati da essa generati mantengono lo stesso 
numero di versione 1.0. Dopo un mese di esperimenti viene prodotta la versione 1.1 
dell’applicazione. Dopo neanche due settimane di ricerche viene scovato e corretto un 
altro bug, e la versione 1.1 è sostituita dalla 1.2. Durante tutto questo processo di 
revisione, il formato dei dati è rimasto inalterato e corrisponde ancora alla versione 1.0. 
Tutte le versioni possono ancora accedere ai dati senza dover operare conversioni. Sei 
mesi più tardi viene introdotta sul mercato la versione 2.0 dell’applicazione, che 
presenta sostanziali differenze dalle versioni precedenti, anche nel formato dei dati. 
La versione del formato dei dati è quindi aggiornata alla V2.0, saltando il processo di 
revisione che ha portato alla creazione delle Vl.leVl.2. Il cambio della versione dei 
dati serve per indicare alle applicazioni con versione precedente che non possono 
gestire il nuovo formato dei dati. Se l’utente dispone dell’ultima versione non dovrebbe 
più utilizzare le versioni precedenti. 

È compito dell’applicazione realizzare (aU’interno dei suoi codici d’inizializzazione) 
alcune routine con lo scopo di controllare la versione dei dati per determinare se 
l’applicazione li può gestire. Nel caso che li possa gestire, l’applicazione deve 
determinare se i dati contenuti nel file devono essere trasformati nel formato corrente. 


Esempio d'impiego del nome permanente 

Supponiamo che l’utente selezioni l’icona corrispondente a un documento generato 
da geoWrite Vl.O; deskTop inizia a cercare lungo la directory un file che contenga nella 
stringa ParentApplication il nome “geoWrite". Nella sua ricerca, deskTop non tiene 
conto della versione, ma confronta solo i primi 12 caratteri dei nomi. Se sul disco non 
è presente alcun file con il nome richiesto, deskTop visualizza un messaggio per 
l’utente nel quale richiede l’inserimento di un disco che contenga un file con quel 
nome. La versione dell’applicazione non compare mai nel nome dell’applicazione. 
Quando deskTop identifica il file geoWrite su disco, comanda a GEOS di caricarlo ed 
eseguirlo. Prima di farlo, deskTop aggiorna alcuni flag e inserisce una stringa che 
contiene il nome del file dati che sarà elaborato da geoWrite. L’applicazione, in questo 
caso geoWrite, riceve il controllo e dispone delle informazioni lasciate da deskTop 
relative al documento da elaborare. Con queste informazioni geoWrite localizza il file 
dati, accede al PermanentName a esso associato e legge la versione del formato dei 
dati memorizzati. Quindi determina se è in grado di leggere i dati direttamente, o se 
deve trasformarli in un formato adatto prima di procedere all’elaborazione. Può anche 
accadere che la versione in esecuzione di geoWrite sia la Vl.O e il file dati sia stato 
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generato con la versione V2.0. In questo caso geoWrite non può elaborare il file e 
termina la propria esecuzione, restituendo il controllo a deskTop, o chiedendo 
l’inserimento di un altro disco. 


Le costanti per accedere €d sistema dei file 

Tutte le costanti riportate nelle tavole precedenti sono state introdotte per facilitare 
il lavoro del programmatore, e sono raccolte organicamente nel file geosConstants in 
appendice. I nomi delle costanti sono studiati espressamente per rendere più 
comprensibile il codice sorgente e aiutare il programmatore a ricordare le posizioni dei 
byte significativi e i valori che determinati byte possono assumere. La maggior parte 
delle costanti si utilizza per puntare particolari byte riportati nelle tavole precedenti. 
Il file geosConstants è suddiviso nelle seguenti sezioni: Tipi dei file in ambiente GEOS, 
Tipi Commodore dei file. Intestazione della directory. File Entry, File Header e Costanti 
per il disco. 


Le v€uiabili per l’accesso al disco 

Quando GEOS si prepara a caricare ed eseguire un’applicazione, ripone in memoria 
una serie di informazioni. Altre informazioni sono mantenute abitualmente in memoria 
da deskTop per suo uso interno: sia le une che le altre sono disponibili all’applicazione 
durante la sua esecuzione. 

Infine, sempre duremte la fase preliminare, deskTop imposta una serie di variabili 
che costituisce il gruppo d’informazioni di prima necessità per l’applicazione. I dati per 
la gestione degli accessori da scrivania (Desk Accessory) sono sostanzialmente 
diversi. Maggiori dettagli per la gestione degli accessori da scrivania si troveranno nei 
prossimi capitoli, nelle descrizioni delle routine GetFile e LdDeskAcc. 

L’applicazione può disporre di diverse variabili create appositamente per comunica¬ 
re con il drive. La variabile curDrive indica il numero del drive che contiene il disco 
sul quale è memorizzata l’applicazione (può essere l’S o il 9). La variabile curDevice 
è allocata all’indirizzo $00BA, dove il C-64 conserva il numero del dispositivo 
attualmente in funzione. All’inizio dell’esecuzione di un’applicazione queste due 
variabili contengono lo stesso valore. Infine i byte Disk ID del disco che contiene 
l’applicazione vengono memorizzati nella memoria interna del drive. 

Durante il processo di caricamento di un’applicazione vengono aggiornate numerose 
variabili. Supponiamo per esempio che l’utente abbia selezionato un file dati: GEOS 
carica in memoria l’applicazione che l’ha creato e le passa il nome del file dati in modo 
che questa sappia automaticamente quale file deve elaborare. Un particolare bit in rOL 
viene impostato a 1 per indicare che è stato specificato il nome di un file dati. In questo 
caso, r3 punta al nome del file dati e r2 punta al nome del disco sul quale è 
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memorizzato. Un’applicazione può essere richiamata anche solo per stampare un file 
dati. In questo caso un altro bit in rOL indica all’applicazione quali sono le operazioni 
da compiere con il file. 

rOL flag loadOpt 

Bit 1 (solo per i file eseguibili) 

0 non è specificato alcun file dati da elaborare automaticamente 
1 è specificato un file dati selezionato dall’utente e l’applicazione deve 
elaborarlo automaticamente (la costante per questo bit è 
ST-LD-DATA). 

Bit 6 (solo per i file eseguibili) 

0 il file dati non è stato selezionato per essere stampato 
1 deskTop imposta a 1 questo bit cjuando l’utente preme una sola volta 
l’icona di un file dati e seleziona l’opzione di stampa. 

L’applicazione deve stampare il file e restituire il controllo a deskTop (la 
costante per questo bit è ST-PR-DATA). 

I registri r2 e r3 contengono dati significativi solo se il bit 1 ed eventualmente il bit 
6 in rOL sono impostati a 1. 

r2 Puntatore al nome del disco che contiene il file dati. Normalmente r2 punta al 
buffer dataDiskName che contiene il nome del disco sul quale si dovrebbe ' 
trovare il file dati da elaborare automaticamente. L’appliceizione, una volta 
individuato il file e operati i relativi controlli di compatibilità, lo elabora secondo 
quanto specificato dal bit 6 in rOL. 

r3 Puntatore al nome del file dati. Di solito r3 indica il buffer dataFileName, che 
contiene il nome del file dati che l’applicazione deve elaborare 
automaticamente. 

Nelle variabili globali di GEOS sono memorizzati anche il File Entry, il blocco File 
Header del file, e il Directory Header Block del disco. 

dirEntryBuf File Entry del file 

curDirHead Directory Header Block del disco che contiene il file 
fileHeader Blocco File Header del file, che GEOS associa a tutti i suoi file 

GEOS memorizza anche una tavola, durante il caricamento del file, che contiene gli 
indirizzi T/S di tutti i blocchi che compongono il file caricato sequenzialmente dal 
disco. Questa tavola è denominata fileTrScTab e occupa un blocco in memoria. 
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fìleTiScTab Lista degli indirizzi T/S dei blocchi del file. Il numero massimo di 
blocchi di cui un file può essere composto è 127 (32.258 byte). 

La prima word della tavola fileTrScTab è l’indirizzo T/S del blocco File Header 
associato al file. Le 127 word seguenti indicano gli indirizzi T/S dei restanti blocchi 
del file. 

r5L Offset dall’inizio della tavola fileTrScTab fino all’ultimo indirizzo T/S 

significativo. r5L punta la word della tavola che individua l’ultimo blocco del 
file. 

Definite le variabili più importanti dedicate alla gestione dei file su disco, possiamo 
iniziare a introdurre le molteplici routine di cui GEOS dispone per comunicare con il 
drive. Il prossimo paragrafo è una panoramica su tutte le routine disponibili e sul modo 
di utilizzarle, e comprende anche un’introduzione su come devono essere effettuati gli 
accessi al bus seriale in ambiente GEOS. 


Le routine di accesso al disco in ambiente GEOS 

'Il Kernel di GEOS mette a disposizione delle applicazioni una serie completa di 
routine di accesso al disco (disk routine). L’insieme di queste routine riesce a 
soddisfare una vastissima gamma di esigenze anche molto diverse fra loro, in quanto 
speizia da routine specifiche molto potenti a routine primitive molto generali. La 
maggior parte delle applicazioni utilizzano solo le routine più complesse, che svolgono 
molte operazioni e sono in grado di soddisfare solo le esigenze più comuni. Routine di 
questo genere vengono chiamate “d’alto livello" in quanto liberano il programmatore 
da buona parte dei problemi secondari. Altre applicazione si trovano a dover soddisfare 
esigenze più particolari, e le routine d’alto livello non sono abbastanza flessibili per 
adattarsi a questi casi. GEOS mette a disposizione a questo scopo una serie di routine 
di livello intermedio che l’applicazione può facilmente combinare insieme per ottenere 
funzioni particolari che non possono essere realizzate con le routine d’alto livello. 
D’altra parte le stesse routine d’alto livello sono combinazioni di routine di livello 
intermedio. 

Infine, GEOS possiede un livello primitivo di routine per l’accesso al disco, 
raramente utilizzate dalle applicazioni. Esse svolgono operazioni semplici ma 
specifiche, in stretto contatto con l’hardware del computer. Se un’applicazione deve 
comunicare con uno speciale dispositivo esterno diverso dalla stampante e dal drive, 
queste routine diventano molto utili. Alcune per esempio permettono all’applicazione 
di chiamare le routine presenti nel Kernel del C-64 e nel DOS del drive. Negli stadi 
finali tutte le routine presenti nei livelli superiori si servono delle routine di livello 
primitivo per comunicare con il drive. 
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Nozioni di base per accedere al disco 

In ambiente GEOS solo un dispositivo esterno alla volta può comunicare attraverso 
il bus seriale. Normalmente è uno dei due drive, A o B, o la stampante, ma in linea 
di massima potrebbe essere qualunque tipo di dispositivo. Per cambiare il dispositivo 
che correntemente impegna il bus seriale viene utilizzata la routine SetDevice. Quando 
un dispositivo impegna il bus seriale si dice "attivato”. L’applicazione deve passare a 
SetDevice il numero del dispositivo che si vuole attivare, per esempio 8 o 9 per i due 
drive. 

Se il dispositivo selezionato è un drive, l'operazione successiva è quella di chiamare 
la routine OpenDisk per iniziare la procedura di accesso al disco. OpenDisk inizializza 
il drive e alcune variabili che il Kernel di GEOS impiega per l’accesso al disco. 

Una volta che la comunicazione con il drive è stata avviata, l’applicazione può 
chiamare una delle seguenti routine. 


Routine d’alto livello 


SetDevice 

OpenDisk 

GetPtrCurDkNm 

SetGEOSDisk 

ChkDkGEOS 

FindFTypes 

GetFile 


FindFile 

SaveFile 

DeleteFile 

RenameFile 

EnterDeskTop 

CalcBlksFree 
Routine VLIR 


- Cede il bus seriale al dispositivo prescelto. 

- Prepara il sistema ad accedere al disco correntemente 
inserito. 

- Restituisce un puntatore che individua il buffer contenente il 
nome del disco. 

- Converte un normale disco utilizzato in modo C^4 in un disco 
in formato GEOS, allocando il blocco Off Page per la directory. 

- Controlla se il disco correntemente attivato è in formato 
GEOS. 

- Genera una lista contenente tutti i file presenti su disco 
appartenenti a un tipo particolare. 

- Passando il nome di un file, la routine lo carica in memoria. 
Si può trattare di un file dati, di un’applicazione o di un 
accessorio da scrivania. Se il file è eseguibile, GetFile lo 
esegue. 

- Scorre la directory, compreso il blocco Off Page, alla ricerca dei- 
file specificato. Restituisce il File Entry. 

- Salva una zona di memoria in un file GEOS su disco. 

- Cancella un file da disco. 

- Cambia il nome del file con uno nuovo. 

- Termina l’esecuzione dell’applicazione e restituisce il 
controllo a deskTop. 

- Calcola quanti blocchi sono ancora disponibili sul disco. 

- Vedere il capitolo dedicato alla struttura VLIR. 
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Routine di livello intermedio 


Le routine che abbiamo appena elencato non possono ovviamente soddisfare tutte 
le possibili esigenze. Per esempio, GEOS non fornisce alcuna routine in grado di 
formattare un disco o copiare un file. La maggior parte delle applicazioni hanno 
raramente bisogno di copiare dischi o file e quindi queste possibilità non sono state 
incluse nel Kernel di GEOS. Nonostante questo, deskTop prevede entrambe le 
funzioni. deskTop è un’applicazione come le altre (geoWrite o geoPaint per esempio), 
con la differenza che è dedicata alla manipolazione dei file. Le funzioni di copia, di 
formattazione e di convalida disponibili in deskTop sono state realizzate combinando 
opportunamente le routine di livello intermedio. 

Il programmatore deve prestare particolare attenzione quando impiega le routine di 
livello intermedio, dal momento che queste si aspettano che l’applicazione abbia già 
compiuto determinate operazioni quando sono in esecuzione. Chiamandone una senza 
aver preventivamente inizializzato le variabili e/o le tavole necessarie, è possibile 
alterare accidentalmente i dati su disco, bloccare il sistema definitivamente o 
entrambe le cose. In particolare molte routine si aspettano che il Kernel mantenga in 
memoria la copia del blocco su disco nel quale è contenuta la Directory Header, e che 
i dati memorizzati in questo blocco, locato a curDirHead, siano corretti. Se un dato 
viene alterato, dopo l’aggiornamento è necessario riscrivere il blocco su disco. La lista 
che segue riporta i nomi delle routine di livello intermedio, con una breve descrizione, 
seguendo un ideale ordine di utilità decrescente. 


GetBlock 

PutBlock 

GetFHdrlnfo 

ReadFile 

WriteFile 

ReadByte 

GetDirHead 

PutDirHead 

NevifDisk 

LdApplic 

LdFile 

LdDeskAcc 


- Legge un blocco del disco. 

- Memorizza su disco un blocco ed effettua la verifica dei dati 
scritti. 

- Passando il File Entry di un file restituisce il blocco File 
Header del file. 

- Legge da disco una serie di blocchi concatenati 
sequenzialmente. 

- Trasferisce il contenuto di una zona di memoria in una serie 
di blocchi concatenati sequenzialmente su disco. 

- Simula la lettura di un byte alla volta, da un gruppo di blocchi 
concatenati sequenzialmente su disco. 

- Legge dal disco la Directory Header e la BAM. 

- Memorizza sul disco la Directory Header e la BAM. 

- Inizializza il drive per accedere a un nuovo disco senza 
alterare le variabili GEOS. 

- Carica ed esegue un’applicazione GEOS compatibile. 

- Carica un file GEOS. 

- Carica ed esegue un accessorio da scrivania GEOS 
compatibile. 
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RstrAppl - Routine eseguita dai DA quando terminano la loro esecuzione. 

GetFreeDirBlk - Individua lo spazio libero nella directory per un nuovo File 

Entry. Se necessario alloca un nuovo blocco per la directory. 

BlkAlloc, 


NxtBlkAlloc 

SetNextFree 

FindBAMBit 

FreeBlock 

SetGDirEntry, 

BldGDirEntry 

FollowChain 

FastDelFile 

FreeFile 

ChangeDiskDevice - 
StartAppl 


Allocano un concatenamento di blocchi sul disco. 

Alloca il primo blocco libero che incontra sul disco. 
Restituisce lo stato di un blocco su disco (allocato o libero). 
Disalloca un blocco particolare su disco. 

Crea in memoria e su disco il File Entry di un file. 

Crea una lista di indirizzi T/S di blocchi appartenenti a un 
concatenamento e la memorizza nella tavola a fileTrScTab. 
Disalloca tutti i blocchi indicati dalla lista di indirizzi T/S 
memorizzata nella tavola a fileTrScTab. 

Disalloca tutti i blocchi di un file. Lascia il File Entry intatto. 
Cambia il numero di device (8 o 9) a cui corrisponde il drive. 
Riconfigura il sistema a una situazione di default. 


Routine di livello primitivo 

GEOS mette a disposizione anche un gruppo di routine di livello primitivo. Possono 
esserci solo tre ragioni per impiegare queste routine; 

1) per accedere alle routine contenute nel Kernel del C-64. deskTop accede alle 
routine del Kernel del C-64 per formattare il disco 

2) per comunicare con un dispositivo diverso da un drive o una stampante 

3) per realizzare routine di accesso al disco particolarmente ottimizzate, in grado di 
muovere un grande numero di blocchi organizzati su disco in qualche maniera 
insolita. Questa possibile applicazione rappresenta un caso estremo e di solito le 
routine per leggere e scrivere i dati raggruppati in blocchi concatenati sono 
sempre sufficienti. 

Ecco quali sono le operazioni non realizzabili direttamente tramite GEOS, per le 
quali un’applicazione potrebbe avere la necessità di accedere al bus seriale. Le routine 
che elenchiamo sono state realizzate per offrire accessi sicuri al bus seriale e ritorni 
altrettanto sicuri al sistema dei file gestito da GEOS. 
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InitForlO 


DoneWithIO 


PurgeTurbo 


EnterTurbo 

ExitTurbo 

ReadBlock 

WriteBlock 

VerWriteBlock 


- Disabilita tutti gli interrupt, disattiva gli sprite, configura i 
banchi di memoria in modo che siano accessibili il Kernel del 
C-64 e lo spazio di I/O. 

- Ripristina tutti gli interrupt, riattiva gli sprite, configura i 
banchi di memoria in modo che tutta la RAM disponibile sia 
accessibile (la normale situazione in ambiente GEOS). 

- Normalmente il codice del turbo è sempre in esecuzione. 
PurgeTurbo rimuove il codice del turbo memorizzato nella 
RAM del drive 1641 e restituisce il controllo del bus seriale al 
DOS. 

- Attiva, caricandolo se è stato rimosso, il codice del turbo 
presente nel drive. 

- Disattiva il codice del turbo nel drive, ma non lo disalloca. 

- Legge un blocco da disco. Il codice del turbo residente nel 
drive dev’essere già in esecuzione, e la routine InitForlO 
dev'essere già stata chiamata. 

- Memorizza un blocco su disco. Non viene eseguita alcuna 
verifica, il codice del turbo dev’essere in esecuzione e la 
routine InitForlO dev’essere già stata eseguita. 

- Come WriteBlock, e inoltre verifica che il trasferimento dei 
dati sia avvenuto in maniera corretta. 


Le comunicazioni con il bus seriale 

Ecco la procedura da adottare per accedere con successo al bus seriale del C-64: 

1) chiamare la routine SetDevice per attivare le comunicazioni con il dispositivo 
prescelto. SetDevice cede il bus seriale al dispositivo 

2) se si desidera utilizzare le routine rese disponibili dal DOS del 1541, si deve 
disattivare il codice del turbo presente nel drive tramite la routine PurgeTurbo. 
Se non si deve accedere alle routine del Kernel del C-64, questo punto è da 
saltare 

3) chiamare InitForlO per disabilitare gli interrupt, gli sprite e abilitare lo spazio 
di I/O e il Kernel del C-64 

4) chiamare le routine del Kernel del C-64 per accedere al bus seriale e comunicare 
con dispositivi esterni 

5) quando si è finito di utilizzare il bus seriale, si deve chiamare DoneWithIO. 
Questa routine ripristina la configurazione di sistema precedente alla chiamata 
di InitForlO. La successiva disk routine di GEOS che l'applicazione chiama 
(eccettuate ReadBlock, WriteBlock o VerWriteBlock) riattiva automaticamente 
il turbo di accesso al disco. 
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La trasfonn€izione dei file normali in file GEOS 

Trasformare un file normale, di qualsiasi forma e struttura, in un file GEOS, significa 
doteirlo del blocco File Header, e quindi di tutte le informazioni in esso contenute, ed 
espanderne il File Entry. Queste operazioni possono essere compiute indifferentemen¬ 
te su file Basic, file in Assembly e file dati che non sono stati creati per interagire con 
l’ambiente GEOS. 

Per effettuare la trasformazione, è sufficiente richiedere all’applicazione Icon Editor 
di cambiare l’icona del file interessato. L’applicazione è in grado di determinare se il 
file è in formato GEOS o meno, e in questo secondo caso chiede all’utente le 
informazioni necessarie per procedere alla trasformazione. Prima di farlo, è comunque 
buona norma effettuare una copia di salvataggio del file, per non rischiare di perderlo 
se nascono problemi. 





ROUTINE 
D'ALTO LIVELLO 


Nel sistema operativo GEOS sono disponibili molte routine per accedere ai file e 
manipolarli. Questa collezione di funzioni spazia dalle routine d’alto livello a quelle più 
elementari che costituiscono la struttura di base delle routine di livello superiore. Nel 
capitolo vengono illustrate le seguenti routine. 

SetDevice 

OpenDisk 

GetPtrCurDkNm 

SetGEOSDisk 

ChkDkGEOS 

FindFTypes 

GetFile 

FindFile 

SaveFile 

DeleteFile 

RenameFile 

EnterDeskTop 

CalcBlksFree 


Prima di iniziarne la descrizione, ricordiamo che tutte le routine restituiscono nel 
registro x il codice d’errore da disco. Questo codice informa sull’esito del tentativo 
d’accesso al disco (positivo x = 0, negativo x 9^ 0). 

Nel caso che x sia diverso da zero, il valore restituito identifica il tipo di errore. Per 
una consultazione dei possibili errori da disco gestiti da GEOS si veda l’appendice. 




Funzione: Cede il bus seriale al dispositivo indicato. 

Indirizzo: $C2B0 

Parametri: a numero del dispositivo (8-11 per il disk drive, 4 per la 

stampante) 

curDevice dovrebbe già essere impostato per il dispositivo corrente 

Restituisce: curDevice numero del nuovo dispositivo, come passato in a 

curDrive se il nuovo dispositivo è un disk drive (8 -11) il suo numero di 
device è memorizzato in curDrive 

X codice d’errore di accesso al disco (vedere i codici d’errore 

riportati in appendice) 

Distrugge: a, x, y 

Sinossi: È necessario impiegare SetDevice quando si desidera cambiare il dispositivo 

che sta utilizzando il bus seriale. Se il dispositivo corrente è un disk drive, 
GEOS effettua una chiamata a ExitTurbo chiedendo al turbo in esso 
memorizzato di cedere al DOS il controllo del bus seriale. Il turbo presente 
nella RAM del drive non viene cancellato, ma il drive si configura in modo 
DOS 1541. Se si desidera cedere il bus seriale alla stampante bisogna 
passare come numero di device il 4. 






Funzione: Inizializza il drive per accedere a un nuovo disco. Dev'essere già stata 

eseguita la routine SetDevice. 

Indirizzo: $C2A1 

Chiama: NewDisk, GetDirHead, ChkDkGEOS, GetRrCurDkNm 

Parametri: curDrive dovrebbe già essere stata impostata da SetDevice per 

indicare il drive desiderato 

memorizza in questo buffer il nome del disco. Il carattere “?” 
presente nel nome della variabile, dev’essere sostituito con 
i caratteri A o B, per indicare se si tratta del buffer del drive 
A 0 del drive B. L’indirizzo del buffer si ottiene chiamando la 
routine GetRrCurDkNm 

punta a Dr?CurDkNm. Viene ottenuto chiamando la routine 
GetRrCurDkNm 

il Directory Header Block del disco, ottenuto chiamando la 
routine GetDirHead 

se il disco è in formato GEOS questo flag è impostato a 
TRUE. Viene ottenuto chiamando la routine ChkDkGEOS 
codice d’errore (0 se non c’è nessun errore. Vedere 
l’appendice per i vari codici d’errore) 

Distraggo: a, x, y, rO - r4, r6 - r15 

Sinossi: OpenDisk inizializza l’accesso al disco inserito nel drive corrente. Si ricorre 

a OpenDisk quando l’utente inserisce un nuovo disco, dopo l’esecuzione di 
SetDevice per cedere il bus seriale al drive corrente. La routine chiama 
NewDisk per preparare il drive al nuovo disco. In seguito OpenDisk chiama 
la routine GetDirHead per leggere il Directory Header Block e memorizzarlo 
nel buffer curDirHead. Poi chiama ChkDkGEOS e imposta a TRUE il flag 
isGEOS se il disco è in formato GEOS. Dopo questa operazione, chiama 
GetRrCurDkNm per leggere il nome del disco (la stessa stringa che compare 
sotto l’icona del drive) e memorizzarlo nel buffer Dr?CurDkNm (il carattere 
“?” dev’essere sostituito da A o da B per indicare il drive corrente). Questo 
buffer è puntato dal registro r5. Se il codice turbo non è attivo, la routine lo 
installa e lo lascia in esecuzione per eventuali nuovi accessi al disco. 


Restituisce: Dr?CurDkNm 

r5 

curDirHead 

isGEOS 

X 






Funzione: Restituisce un puntatore a uno dei due buffer DrACurDkNm e DrBCurDkNm. 

Il buffer puntato contiene il nome del disco presente nel drive correntemente 
selezionato. 


Indirizzo: $C298 

Chiamata da: OpenDisk 

Chiama: BBMult 

Parametri: x indirizzo del registro in pagina 0 nel quale la routine deve 

restituire l’indirizzo del buffer che contiene il nome del disco. 
Per esempio: Idx #r8 significa che la routine utilizza r8. Il 
registro r15 non può essere impiegato 
curDrive numero del disk drive correntemente selezionato, di solito 8 
o9 

DrACurDkNm contiene il nome del disco nel drive A 
DrBCurDkNm contiene il nome del disco nel drive B 

Restituisce: Il puntatore a Dr?CurDkNm memorizzato nel registro specificato da x 

Distrugge: a, y, r15 

Sinossi: GetRrCurDkNm utilizza la variabile curDrive per determinare quale dei due 

drive è correntemente selezionato (drive A o B). Quindi restituisce nel registro 
puntato da x l’indirizzo del buffer DrACurDkNm o DrBCurDkNm contenente 
il nome del disco. Per utilizzare questa routine è sufficiente passare in x 
l’indirizzo del registro che si desidera impiegare; per esempio, se 
l’applicazione esegue l’istruzione Idx #r8, la routine restituisce il puntatore 
nel registro r8. Può essere impiegato qualsiasi registro, eccetto r15 che viene 
utilizzato internamente. Il nome per il disco corrente deve già essere 
memorizzato in DrACurDkNm o DrBCurDkNm. Il registro specificato viene 
restituito come puntatore al buffer Dr?CurDkNm. 






Funzione: Scrive la stringa d’identificazione GEOSID all’Interno della Directory Header 

del disco, alloca il blocco Off Page della directory, riscrive nel disco la 
Directory Header e la BAM. In questo modo il disco viene convertito nel 
formato GEOS. 

Indirizzo: $01EA 

Chiama: GetDirHead, CalcBIksFree, SetNextFree, PutDirHead 

Parametri: curDrive numero del drive corrente (8 o 9) 

Restituisce: curDirHead contiene la stringa GEOS ID e il puntatore T/S al blocco Off Page 

della directory 

disco la Directory Header aggiornata e il blocco Off Page allocato 

Distrugge: a, x, y 

Sinossi: SetGEOSDisk converte un normale disco, già formattato e utilizzabile in 

ambiente C-64, in un disco in formato GEOS, salvaguardando tutti i dati 
presenti. Il formato GEOS si ottiene aggiungendo al disco la stringa GEOS 
ID e allocando il nuovo blocco Off Page della directory. SetGEOSDisk chiama 
la routine GetDirHead per leggere la Directory Header del disco e 
memorizzarla nella variabile curDirHead. Nello spazio della Directory Header 
normalmente inutilizzato, la routine memorizza la stringa GEOS ID 
d’identificazione del formato GEOS. In seguito alloca un settore del disco 
(tramite CalcBIksFree e SetNextFree) per contenere il blocco Off Page, e 
memorizza l’indirizzo T/S a questo settore nei byte 171 e 172 del Directory 
Header Block. SetDevice dev’essere già stata eseguita quando viene 
chiamata SetGEOSDisk, in modo che la variabile curDevice contenga il 
numero corretto del drive e quest’ultimo abbia accesso al bus seriale. 






Funzione: Cerca la stringa GEOSID nel disco corrente per individuare se è in formato 

GEOS. 


indirizzo: $C1DE 

Chiamata da: OpenDisk 

Parametri: r5 puntatore aH’immagine in memoria del Directory Header 

Block, memorizzato di solito a curDirHead 
Directory Header memorizzata di solito aH’interno del buffer curDirHead 

Restituisce: isGEOS TRUE se il disco è in formato GEOS 

a lo stesso valore memorizzato in isGEOS 

Distrugge: x, y 

Sinossi: ChkDkGEOS controlla se il disco inserito nel drive è in formato GEOS. Il 

controllo consiste nella lettura della stringa GEOS ID, contenuta nella 
Directory Header del disco, che dovrebbe essere stata opportunamente 
memorizzata nel buffer puntato da r5. Se questa stringa è presente, il flag 
isGEOS è impostato a TRUE. Si noti che il buffer puntato da r5 deve 
contenere l’intero Directory Header Block; ChkDkGEOS provvede poi a 
individuare aH’interno di questo blocco la Directory Header. 





Funzione: Restituisce i nomi dei file caratterizzati dai tipo GEOS specificato. 

Indirizzo: $C23B 


Chiamata da: La routine di gestione dei comando DBGETFILES per i box di dialogo 

Parametri: r6 puntatore al buffer destinato a contenere i nomi dei file. Ogni nome è 

composto da un massiffio di 16 caratteri più b 0 come diciassettesimo 
r7L tipo GEOS dei file da cercare 
r7H massimo numero di nomi di file da inserire nella lista 
r10 0, per ignorare il nome permanente, oppure un puntatore alla stringa 
a terminazione nulla (lunga non più di 16 caratteri) che dev’essere 
confrontata con i nomi permanenti associati ai file. Questa stringa, 
facoltativa, rappresenta la seconda chiave di ricerca utilizzata da 
FindFTypes. In questo modo, non solo si possono raccogliere tutti i file 
di uno stesso tipo, ma si possono addirittura individuare all'Interno 
del tipo quelli generati dalla stessa applicazione 

Preparazione 

del drive: Per accedere al disco con successo, il drive dev'essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curOrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce: Il buffer viene riempito con i nomi dei file presenti sul disco che rispondono 
alle chiavi (o alla chiave se rIO = 0) di ricerca 

Distrugge: a, y, rO, ri, r2L, r4, r6 
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Sinossi: FindFTypes costruisce una lista di nomi corrispondenti a file dello stesso tipo 

GEOS specificato in r7L. L’applicazione deve passare il tipo GEOS del file, 
un puntatore al buffer entro il quale la routine memorizza i nomi dei file, e il 
massimo numero di nomi che il buffer può contenere. I nomi dei file sono 
memorizzati in stringhe a terminazione nulla e ogni nome è completato da 
zeri sino al diciassettesimo carattere. Il diciassettesimo carattere è sempre 
uno 0, che costituisce il terminatore della stringa. I nomi dei file conservano 
nella lista lo stesso ordine con il quale appaiono sul disco, che è anche 
l’ordine con cui appaiono sul notes di deskTop. I tipi correnti di file sono: 
NOT-GEOS, BASIC, ASSEMBLY, DATA, SYSTEM, DESK-ACC, APPLICA¬ 
TION, APPLDATA, FONT. PRINTER, INPUT-DEVICE, DISKJDEVICE, 
SYSTEM-BOOT, TEMPORARY, AUTO-EXEC. Per le singole spiegazioni, 
consultare l’appendice. 

Facciamo un esempio che chiarisca la funzione svolta da questa routine. 
Quando si manda in esecuzione un’applicazione, si utilizza la routine 
FindFTypes per costruire la lista degli accessori da scrivania disponibili sul 
disco corrente (vengono presi in considerazione solo i primi otto). 
L’applicazione passa a FindFTypes il tipo DESK-ACC del file, il numero dei 
file significativi per la ricerca (MAX_DESK-ACC=8), e il puntatore al buffer 
allocato appositamente. 

Prima che siano memorizzati i nomi dei file, il buffer viene interamente 
azzerato. In questo modo uno 0 come primo carattere di un nome indica la 
fine della lista. Durante il raggruppamento dei nomi, ogni volta che la routine 
incontra un file su disco che corrisponde alle caratteristiche specificate, r7H 
viene decrementato di una unità. Questo registro può essere utilizzato per 
calcolare velocemente il numero di file che la routine ha raggruppato: 
massimo numero di nomi - r7H. 

La routine presenta la possibilità di specificare un’ulteriore chiave di 
ricerca. Questa permette di raggruppare file dello stesso tipo GEQS, per 
esempio APPL-DATA, e in più generati dalla stessa applicazione. 
FindFTypes confronta la seconda chiave di ricerca, realizzata da una stringa 
di caratteri, con il nome permanente di ogni file. Ricordiamo che il nome 
permanente di un file è memorizzato nel blocco File Header e identifica 
l’applicazione da cui proviene il file. Per fare un esempio, se geoPaint 
assegna ai file da essa creati il nome permanente “Paint Image V1.r, 
FindFtypes è in grado di individuarli e raggrupparli fra tutti i file di tipo 
APPL-DATA presenti sul disco, il nome permanente è suddiviso in due parti 
contigue. La prima parte, dal carattere 1 al carattere 12, contiene il nome 
permanente che effettivamente viene confrontato con quello specificato 
dall’applicazione. La seconda parte, dal carattere 13 al carattere 16, contiene 
la versione del formato dei dati usato dall’applicazione e non viene presa in 
considerazione da FindFTypes. Spetta all’applicazione accedere alla 
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versione del formato e trarne le opportune conseguenze 
Per riassumere, il nome permanente è composto da 16 byte significativi 
ed è memorizzato su disco in uno spazio di 20 byte. I quattro byte in più sono 
azzerati. Per introdurre questa seconda chiave di ricerca, l’applicazione deve 
specificare in rIO l’indirizzo della stringa a terminazione nulla che dev’essere 
confrontata con i nomi permanenti dei file che rispondono alla prima chiave 
di ricerca (tipo GEOS del file). GEOS confronta solo il numero di caratteri che 
compongono la stringa puntata da rIO. In questo modo la stringa di ricerca 
non include il numero della versione, e non viene presa in considerazione la 
versione dell’applicazione che ha generato il file. 
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GetFile 


Funzione: È la più importante routine di caricamento ed esecuzione dei file. 

Indirizzo: $C208 

Chiama: FindFile e una delle tre routine LdFile, LdDeskAcc o LdApplic 


Parametri: r6 punta alla stringa che contiene il nome del file. Questa stringa 

dev’essere a terminazione nulla e non più lunga di 16 caratteri, escluso 
il terminatore 
rOL flag IoadOpt 
BitO 

0 segue la procedura standard di caricamento 
1 carica il file all’Indirizzo specificato in r7 (la costante per 
questo bit è ST-LD-AT-ADDR) 

Bit 6 (solo per file eseguibili) 

0 il file non è stato selezionato per essere stampato direttamente 
1 deskTop, per esempio, imposta a 1 questo bit quando l’utente 
muove l’icona di un file dati sopra l’icona della stampante e 
preme il pulsante del mouse. L’applicazione stampa il file e 
termina la sua esecuzione (la costante per questo bit è 
ST_PFLDATA) 

Bit 7 (solo per file eseguibili) 

0 non è specificato alcun file dati 

1 bisogna caricare l’applicazione che ha creato il file selezionato 
dall’utente, perché il file sia automaticamente elaborato (la 
costante per questo bit è ST-LDJDATA) 

r2 e r3 vengono passati solo se: 

1) dev’essere caricata un’applicazione 

2) i bit 6 e/o 7 in rOL sono impostati a 1 


r2 puntatore al nome del disco che contiene il file dati selezionato che 
l’applicazione deve elaborare automaticamente. r2 e il contenuto del 
buffer dataDiskName sono dati importanti per l’applicazione. Questa, 
una volta che è stata caricata e mandata in esecuzione, elabora il file 
dati come specificato nel bit 6 di IoadQpt 
r3 punta al buffer che contiene il nome del file dati. L’applicazione utilizza 
questo puntatore per caricare il file dati in memoria ed elaborarlo 
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Preparazione 
del drive: 


Restituisce: 


automaticamente; r3 e il contenuto del buffer dataFileName sono 
informazioni basilari per l’applicazione, che, dopo averle ricevute, 
elabora il file dati come specificato nel bit 6 di IoadOpt 
r7 contiene l’indirizzo al quale il file dev’essere memorizzato se il bit 0 in 
rOL, individuato da ST_LD_AT_ADDR, è impostato a 1 
r10L flag di ripristino dei DA (Desk Accessory). Quando il file da caricare è 
un accessorio da scrivania, r10L contiene alcuni flag che specificano 
come dev’essere gestito 
Bit 7 bit dello sfondo 

0 GEOS non salva la parte di schermo coperta dalla 

finestra dell’accessorb da scrivania 
1 GEOS salva la parte di schermo che viene nascosta e la 

ripristina al termine dell’esecuzione dei DA (la costante 
per questo bit è FG-SAVE) 

Bit 6 bit del colore 

0 non salva i colori 

1 salva i colori interessati da cambiamenti e li ripristina 

dopo l’esecuzione dei DA (la costante per questo bit è 
CLR-SAVE) 


Per accedere al disco con successo, il drive dev’essere inizializzato. li byte 
d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce il file in memoria all’indirizzo indicato nel blocco File Header del 
file o all’indirizzo specificato dal registro r7. Se il file è un’applicazione, o un 
accessorio da scrivania, viene mandato in esecuzione; il sistema viene 
inizializzato a una configurazione di default e l’esecuzione dell’applicazione 
inizia all’indirizzo specificato nel blocco File Header. Nel caso di un file 
eseguibile, GetFile non restituisce il controllo all’applicazione che l’aveva 
chiamato. r2, r3, r7 e rOL vengono passati all’applicazione o al DA. Nel caso 
di un’applicazione, r7 restituisce il vettore d’inizializzazione (indirizzo di inizio 
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esecuzione), prelevato dal File Header, invece deH’indirizzo al quale allocarlo 
in memoria. dataDiskName, IoadAddr e dataFileName restano inalterati 


X codice d’errore. Un qualunque errore causa la fine dell’ope¬ 

razione e la restituzione del controllo ai codice che aveva 
effettuato la chiamata. Per quanto riguarda gli errori che si 
possono verificare nelle comunicazioni con il drive, vedere 
l’apposita sezione in appendice. 

Suddividiamo ora i parametri restituiti dalla routine a 
seconda delle subroutine di GetFile da cui sono generati 

Dalla chiamata alla routine FindFile: 

dirEntryBuf File Entry del file 

Dalla chiamata alla routine GetFHdrInfo attraverso una delle tre routine LdFile, 

LdApplic, LdDeskAcc (LdApplic a sua volta chiama LdFile): 

fileHeader contiene il blocco File Header previsto dai file GEOS, anche 
se il file è a struttura VUR 

Dalla chiamata alla routine ReadFile attraverso una delle tre routine LdFile, 

LdApplic o LdDeskAcc: 

fileTrScTab lista di indirizzi T/S dei blocchi del file o del record. La 
dimensione massima di un file è 127 blocchi (32.258 byte). 
GetFileHdrInfo memorizza nella prima word della tavola a 
fileTrScTab l’indirizzo T/S del blocco File Header del file. 
Quando viene eseguita GetFile per caricare un file in 
memoria, la routine ReadFile aggiorna la tavola a fileTrScTab. 
Se il file è a struttura VUR, la tavola, a eccezione della prima 
word, contiene la lista degli indirizzi T/S dei blocchi di cui è 
composto il primo record del file 

ri nel caso che, durante il caricamento dei blocchi, raggiunga 

il limite imposto di 127 blocchi, la routine termina la lettura dei 
blocchi e la memorizzazione degli indirizzi T/S nella tavola, e 
il registro ri contiene l’indirizzo T/S del blocco che non è stato 
letto. Questa informazione non viene restituita se viene 
eseguita la routine LdDeskAcc 

r5L offset dall’inizio della tavola fileTrScTab all’ultimo indirizzo T/S 

dell’ultimo blocco del file, o del record 
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Distrugge: 

Sinossi: 


Dalla chiamata alla routine LdDeskAcc: 

font la fonte carattere selezionata è la fonte di sistema. In questo 

modo l’accessorio da scrivania inizia la sua esecuzione con 
la fonte di sistema 

LdApplic e LdDeskAcc effettuano un’inizializzazione “a caldo” del 
sistema. Per sapere con precisione quali sono le variabili di sistema 
interessate da questa procedura, si veda la configurazione di sistema della 
partenza a caldo descritta nel capitolo 20 

a, X, y, rO - r10.1 buffer dirEntryBuf e curDirHead non sono alterati 

GetFile richiede solo il nome del file per caricare in memoria qualsiasi file 
GEOS compatibile. Se il file contiene dati, la routine lo carica alla locazione 
specificata nel blocco File Header del file (vedere la trattazione sulla struttura 
dei file). Se il file è un’applicazione o un DA, la routine lo carica in memoria 
all’indirizzo specificato nel blocco File Header del file e lo esegue. 

Per eseguire queste operazioni, la routine deve per prima cosa cercare 
nella directory del disco il File Entry del file richiesto. Se il disco è in formato 
GEOS, la ricerca si estende anche al blocco Off Page della directory. 
Accedendo alle informazioni contenute nel File Entry, la routine è in grado 
di determinare il tipo GEOS del file e scegliere di conseguenza l’appropriata 
routine di caricamento. La procedura di caricamento dipende dal tipo GEOS 
del file. Per esempio, un file accessorio da scrivania richiede una procedura 
di caricamento sostanzialmente diversa da quella richiesta da un file dati. 

Se l’utente seleziona un file dati e vuole che questo sia automaticamente 
elaborato dall’applicazione che l’ha generato, devono essere impostati gli 
appropriati bit nel flag IoadOpt (rOL) in modo che GEOS sia in grado di 
svolgere questo compito. Per esempio, l’applicazione deskTop utilizza la 
routine GetFile nei seguenti casi: 

1) l’applicazione è stata selezionata dall’utente con la doppia pressione 
del mouse sopra l’icona del file 

2) l’utente ha selezionato il file dati prodotto da una particolare 
applicazione 

3) l’utente ha richiesto la stampa di un file dati selezionandone l’icona e 
attivando l’opzione print del menu file. 

Se deskTop richiede il caricamento di un’applicazione che inizi 
automaticamente l’elaborazione di un file dati, o che effettui la stampa del 
file e restituisca il controllo a deskTop (come avviene nel terzo caso sopra 
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citato), deve fornire all’applicazione le seguenti informazioni: 

1) r2 deve puntare a una stringa in memoria che contenga il nome del 
disco sul quale è memorizzato il file dati 

2) r3 deve puntare a una stringa in memoria che contenga il nome del file 
dati cha l’applicazione deve automaticamente elaborare. 

Queste informazioni sono necessarie nel caso che deskTop debba 
cercare l’applicazione su un disco diverso da quello che contiene il file dati. 
Solo cosi l’applicazione, nonostante sia stata caricata su un altro disco, ha 
informazioni sufficienti per richiedere all’utente d’inserire il disco il cui nome 
è puntato da r2, e per iniziare a elaborare automaticamente il file dati 
originariamente selezionato. Se però i bit del flag IoadOpt non indicano 
nessuno di questi casi, GetFile ignora le informazioni contenute nei registri 
r2 e r3, qualsiasi file debba caricare. In ogni caso il nome del file da caricare 
dev’essere puntato dal registro r6. 

Se il file da caricare è un accessorio da scrivania, il registro r10L deve 
specificare se la parte di schermo nascosta dev’essere salvata, in modo che 
al termine dell’esecuzione GEOS possa ripristinare la situazione precedente 
all’attivazione del desk accessory. Alcune applicazioni non usano il buffer di 
schermo per mantenere una copia dello schermo originale e quindi, dopo 
l’esecuzione dell’accessorio da scrivania, devono ripristinare lo schermo 
originale utilizzando metodi propri. 





Funzione: Cerca e carica in memoria il File Entry del file specificato. 

Indirizzo: $C20B 


Chiamata da: GetFile, FastDelFile, RenameFile 

Parametri: r6 puntatore alla stringa che contiene il nome del file. La stringa 

dev’essere a terminazione nulla e non più lunga di 16 
caratteri, terminatore escluso 

Preparazione 

del drive: Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Accede a: disco i File Entry nella directory del disco 

Restituisce: x codice d’errore da disco 

diskBIkBuf il blocco della directory che contiene il File Entry cercato 
dirEntryBuf File Entry del file 

curDirHead il Directory Header Block del disco 

rIL, rIH indirizzo T/S del blocco della directory interessato 

r5 puntatore al File Entry del file memorizzato aH’interno del 

buffer diskBIkBuf 

Distrugge: a, y, r4, r6 
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Sinossi: 


FindFile richiede soltanto il nome del file da 16 caratteri e la presenza di un 
disco, nel drive correntemente attivato, dove effettuare la ricerca del file. Il 
disco deve già essere stato “aperto” tramite OpenDisk o NewDisk (le quali 
a loro volta richiedono che sia già stata eseguita la routine SetDevice). La 
routine cerca il File Entry del file scorrendo i blocchi della directory, compreso 
il blocco Off Page se il disco è in formato GEOS. Se lo trova, il blocco della 
directory in cui si trova e il File Entry stesso vengono trasferiti in memoria per 
essere utilizzati con altre routine di lettura e scrittura su disco. Se il file non 
si trova sul disco o si verifica un errore nell’accesso al disco, per operare le 
appropriate scelte l’applicazione può consultare il registro x, che contiene il 
codice dell’errore. Normalmente il nome del file specificato per la ricerca è 
uno di quelli elencati dalla routine FindFTypes o una stringa in input 
dall’utente. 





Funzione: Salva un’area di memoria su disco come un file a struttura SEQUENTIAL. 

SaveFile viene anche impiegata per creare su disco un file vuoto a struttura 
VLIR. 


Indirizzo: $C1ED 

Chiama: GetDirHead, SetGDirEntry, PutDirHead 

Parametri: r9 puntatore al blocco File Header. Quando il File Header viene 

memorizzato su disco, i primi due byte contengono 
rispettivamente i valori $00 e $FF. Quando il blocco viene 
passato a SaveFile, questi due byte devono contenere un 
puntatore che individua in memoria una stringa a terminazio¬ 
ne nulla contenente il nome del file. Per maggiori dettagli sulla 
struttura del blocco File Header si consulti il capitolo 13 
rIOL numero della pagina (blocco) della directory nella quale la 

routine deve provare a memorizzare il File Entry del file da 
salvare su disco. La suddivisione in pagine delia directory è 
utile per raffigurare i fogli del bloc notes utilizzato da deskTop 
per indicare i file in directory. Ognuna di queste pagine è 
memorizzata in un blocco della traccia 18, riservata alla 
directory del disco. Se per esempio l’applicazione passa il 
numero 4 in rIOL, SaveFile tenta di memorizzare il File Entry 
del file nel quarto blocco della directory (si assume che il 
primo blocco, quello che contiene la BAM, sia il blocco 0) 

contiene il blocco File Header come è stato memorizzato su 
disco 

contiene il Directory Header Block ottenuto dalla chiamata 
a GetDirHead 

puntatore alla tavola fileTrScTab 
puntatore al blocco File Header in memoria 
contiene il nuovo File Entry per il file 
il disco contiene la nuova BAM e la nuova Directory Header 
il nuovo blocco File Header e il file memorizzati su disco 
se il file è a struttura VLIR viene creata la tavola indice 
codice d’errore da disco 


Restituisce: fiieHeader 

curDirHead 

r6 

r9 

dirEntryBuf 

disco 

disco 

disco 

X 
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Distrugge: a, y, rO - r8 

Sinossi: SaveFile salva su disco un'area di memoria per un file a struttura 

SEQUENTIAL compatibile con lo standard GEOS. Per effettuare questa 
operazione, SaveFile ha bisogno che siano passati il blocco File Header del 
file e il numero della pagina della directory nella quale memorizzare il File 
Entry. Il File Header contiene la maggior parte delle informazioni necessarie 
a SaveFile per creare il File Entry in directory e memorizzare il file su disco: 
l’icona, il tipo di file, l’indirizzo di caricamento, di esecuzione e di fine file, la 
stringa della versione. Per maggiori dettagli sul blocco File Header consultare 
il capitolo 13. 

L’unica informazione che non appare nel blocco File Header, ma 
dev’essere presente nel File Entry del file salvato su disco è il nome. SaveFile 
si aspetta quindi di trovare nei primi due byte del blocco File Header, 
residente ancora in memoria, l’indirizzo della stringa a terminazione nulla che 
contiene il nome da dare al file. I nomi di file possono arrivare sino a 16 
caratteri significativi più uno 0 come terminatore. 

SaveFile può essere utilizzata per creare un file a struttura VUR, vuoto. 
L’unica differenza, in questo caso, consiste negli indirizzi di inizio file 
(indirizzo di caricamento) e di fine file che devono essere rispettivamente 
$0000 e SFFFF. In questo modo la routine sa che non deve allocare alcun 
blocco di dati su disco. La struttura GEOS del file memorizzata nel File 
Header deve indicare che il file è organizzato con la struttura VUR. Quando 
SaveFile chiama SetGDirEntry, viene allocato su disco un blocco per 
contenere la tavola indice del file. In questo blocco SaveFile memorizza una 
tavola indice vuota. 

Ogni pagina del bloc notes raffigurato in deskTop rappresenta un blocco 
della directory allocato nella traccia 18. Il numero passato in rIOL è il numero 
della pagina nella quale SaveFile prova a memorizzare il File Entry del file (si 
noti che la terza pagina, o blocco, della directory non è memorizzata nel terzo 
settore della traccia 18, ma nel settore che rende minima la distanza con il 
blocco precedente). Se la pagina richiesta risulta piena, SaveFile esamina le 
pagine che seguono fino a quando non trova uno spazio libero per 
memorizzare il File Entry. Al limite, la routine è in grado di allocare un nuovo 
settore come blocco della directory, se non ha trovato spazio nei blocchi 
esaminati. 
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Funzione: Cancella un file C-64, GEOS SEQUENTIAL o VLIR dal disco. 

Indirizzo: $C238 


Chiama: FindFile, FreeFile 

Parametri: rO puntatore al nome del file (stringa a terminazione nulla) 

Preparazione 

del drive: Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo dei 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce: x codice d’errore da disco 

curDirHead il Directory Header Block in memoria viene aggiornato per 

indicare i cambiamenti effettuati su disco 
disco la BAM viene aggiornata 

disco viene aggiornato il blocco della directory che conteneva il File 
Entry 

disco il blocco File Header e la tavola indice (se file VLIR) vengono 
cancellati dal disco come il resto del file 
dirEntryBuf restituito per via della chiamata a FindFile 
r9 punta al buffer dirEntryBuf 

Distrugge: a, y, rO - r9 

Cancella dal disco il file con il nome specificato. Per disallocare i blocchi del 
file, la routine utilizza esclusivamente le routine del turbo di GEOS, e non 
accede ad alcuna routine del DOS. Tramite DeleteFile possono essere 


Sinossi: 
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cancellati dal disco file di qualunque dimensione e anche con struttura VLIR. 
Il File Entry del file viene rimosso dalla directory, ma ne resta una copia nel 
buffer dirEntryBuf. Ogni settore del file è contrassegnato nella BAM come 
disallocato. Se il file è di tipo C-64 REL, il puntatore al side-sector non è 0, 
e punta a una concatenazione di blocchi. Anche in questo caso, i blocchi 
vengono cancellati. Se il file è a struttura VLIR vengono cancellati la tavola 
indice, il File Header e tutti i record di cui si compone. 




Funzione: Assegna al file un nuovo nome. 

Indirizzo: $C259 

Chiama: FindFile 


Parametri: r6 puntatore al vecchio nome (a terminazione nulla) 

rO puntatore al nuovo nome (a terminazione nulla) 

Restituisce: dirEntryBuf contiene il File Entry del file aggiornato con il nuovo nome 
diskBIkBuf conserva una copia del blocco della directory che contiene il 
File Entry del file. La stringa del vecchio nome viene sostituita 
airinterno del File Entry con la stringa del nome nuovo e il buffer 
diskBIkBuf viene nuovamente memorizzato sul disco 
X codice d’errore da disco 

Preparazione 

del drive: Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Distrugge: a, x, y, r1, r4 - r6 

Sinossi: Questa routine assegna al file specificato un nuovo nome. FindFile carica in 

memoria il File Entry del file al quale si desidera cambiare il nome. Subito 
dopo, la routine aggiorna il File Entry con il nuovo nome e lo riscrive sul disco. 
Il nome puntato da r6 (il vecchio nome) non dev’essere memorizzato nel 
buffer dskBIkBuf dal momento che quella zona di memoria viene cancellata 
quando FindFile scorre i blocchi della directory alla ricerca del file. 






Funzione: Inizializza il sistema a uno stato di default, carica in memoria deskTop e la 

esegue. 

Indirizzo: $C22C 


Chiamata da: Tutte le applicazioni quando concludono la loro esecuzione 

Parametri: Nessuno 

Restituisce: Il sistema inizializzato a uno stato di default tramite una partenza “a caldo” 

Distrugge: Il sistema è interamente inizializzato 

Sinossi: Quando un’applicazione termina la propria esecuzione, dovrebbe eseguire 

l’istruzione jmp EnterDeskTop. Questa routine effettua una partenza a caldo 
del sistema, carica in memoria deskTop e la esegue. Se GEOS non trova sul 
disco corrente l’applicazione deskTop, visualizza un box di dialogo e chiede 
che venga inserito un disco contenente deskTop. 






Funzione: 

Calcola il numero di blocchi liberi sul disco scorrendo la BAM. 

indirizzo: 

SCI DB 


Chiamata da: 

BIkAlloc, NxtBIkAlloc, SetGEOSDisk 

Parametri: 

r5 

punta al buffer che contiene il Directory Header Block. 
Normalmente questo buffer è curDirHead 

Restituisce: 

r4 

il numero di blocchi liberi presenti su disco (è una word) 


r5 

inalterato 

Distrugge: 

a. y 


Sinossi: 

Dopo aver 

ricevuto il Directory Header Block del disco corrente, 


CalcBIksFree accede alla BAM e calcola il numero di blocchi liberi del disco. 
Sul disco vi sono 35 tracce. AH'interno della BAM vi è un gruppo di bit per 
ogni traccia. Ognuno di questi gruppi è composto da quattro byte. Il primo 
byte di ogni gruppo indica quanti blocchi sono contenuti nella traccia. I 
rimanenti tre byte contengono un bit per ogni settore della traccia. La BAM 
è allocata dal byte in posizione $04 al byte in posizione $8F (dal 4 al 143) 
del Directory Header Block, traccia 18 settore 0. 






J C ROUTINE DI 
■ Q LIVELLO INTERMEDIO 


Nel capitolo precedente abbiamo trattato le routine d’alto livello di cui dispone 
GEOS per gestire il sistema dei file. Questo capitolo descrive le routine di livello 
intermedio. Combinandole opportunamente fra loro si possono realizzare alcune 
funzioni particolari che solo per ragioni di spazio non sono state inserite nel Kernel di 
GEOS, come per esempio le routine di copia dei file e dei dischi. Queste funzioni non 
direttamente previste da GEOS sono facili da realizzare e possono essere ottimizzate 
per le specifiche applicazioni. Nel livello intermedio sono incluse le seguenti routine: 

GetBlock GetFreeDirBlk 

PutBlock BlkAlloc 

GetFHdrInfo NxtBlkAlloc 

ReadFile SetNextFree 

WriteFile FindBAMBit 

ReadByte FreeBlock 

GetDirHead SetGDirEntry 

PutDirHead BldGDirEntry 

NewDisk FollowChain 

LdApplic FastDelFile 

LdFile FreeFile 

LdDeskAcc ChangeDiskDevice 
RstrAppl StartAppl 

Prima d’iniziare la descrizione di queste routine, ricordiamo che tutte restituiscono 
nel registro x il codice d’errore da disco. Questo codice informa sull’esito del tentativo 
d’accesso al disco (positivo se x = 0, negativo sex ^ 0). Nel caso che x sia diverso da 
zero, il registro contiene il codice che identifica l’errore. Per un riassunto di tutti gli 
errori da disco gestiti da GEOS consultare l’appendice. 




Funzione: Routine di livello intermedio standard per prelevare un blocco da disco. 

Indirizzo: $C1E4 

Chiamata da: GetFHdrInfo, UpdateRecordFile 

Chiama: EnterTurbo, InitForlO, ReadBlock, DoneWithIO 

Parametri: r1L, r1H indirizzo T/S del blocco da leggere 

r4 puntatore al buffer nel quale memorizzare i dati prelevati da disco 
(generalmente diskBIkBuf) 

Preparazione 

dei drive: Il drive dev’essere inizializzato attraverso OpenDisk o NevtOisk, e deve 

corrispondere al dispositivo selezionato sul bus seriale attraverso SetDevice. 

Restituisce: x codice d’errore da disco 

r4 puntatore al buffer in memoria nel quale è stato memorizzato il 
blocco prelevato da disco (è rimasto inalterato) 
r1 inalterato 

Distrugge: a, x, y 

Sinossi: Passando l’indirizzo T/S dei blocco che dev’essere letto, GetBlock lo preleva 

dal disco e lo memorizza nel buffer specificato. GetBlock carica un blocco 
da disco e lo memorizza nella memoria del C-64 utilizzando il codice turbo 
di cui è dotato GEOS. Dopo essere stato trasferito in memoria, il blocco 
contiene ancora nei primi due byte l’indirizzo T/S del settore successivo, se 
appartiene a un concatenamento. GetBlock è una routine di livello intermedio 
e si presta a essere impiegata per trasferire un singolo blocco dal disco alla 
memoria del C-64 (generalmente nel buffer diskBIkBuf), o per realizzare 
funzioni personalizzate. Questo secondo tipo d’impiego è poco indicato per 
i programmatori non molto esperti. 
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Ecco uno schema a blocchi che illustra le principali operazioni compiute 
da GetBlock: 

disabilita gli interrupt, 
disabilita gli aprite, 

attiva il codice turbo nel drive (se necessario lo trasferisce nel drive), 
legge il blocco, 

disattiva il codice turbo nel drive, 
attiva gli sprite, e 
attiva gli interrupt. 

GetBlock trasferisce sempre e solo i 256 byte che compongono il blocco 
indicato, anche se si tratta dell’ultimo blocco di un settore. Fino alla versione 
1.2 del Kernel, nel caso che il primo byte del blocco fosse 0 (ultimo blocco 
del concatenamento), GetBlock trasferiva solo i byte significativi che 
conteneva. Dalla versione 1.3 in avanti, la routine GetBlock legge in ogni 
caso tutti i byte del settore indicato, significativi e non. Questo cambiamento 
è stato effettuato per permettere alle applicazioni di utilizzare GetBlock anche 
nella lettura di blocchi non organizzati secondo il consueto concatenamento 
Traccia/Settore. Questo caso interessa particolarmente alcuni dischi 
disponibili per il C-64, contenenti dati grafici memorizzati secondo strutture 
inconsuete. 





Funzione: Memorizza su disco un blocco di memoria. Se il blocco appartiene a un 

concatenamento deve contenere l’indirizzo T/S del successivo. 


Indirizzo: $C1E7 

Chiama: EnterTurbo, InitForlO, WriteBlock, DoneWithIO 

Parametri: r1L, r1H indirizzo T/S del settore su disco nel quale viene memorizzato il 

blocco 

r4 puntatore in memoria all’inizio del blocco, di solito diskBIkBuf 

Preparazione 

del drive: Il drive dev’essere inizializzato attraverso OpenDisk o NewDisk, e deve 

corrispondere al dispositivo selezionato sul bus seriale attraverso SetDevice. 


Restituisce: 

X 

codice d’errore da disco 


r4 

inalterato 


r1 

inalterato 

Distrugge: 

a, X, y 



Sinossi: PutBlock trasferisce un blocco dalla memoria del C-64 al disco corrente 

utilizzando il codice turbo. Perché un file sia trasferito su disco correttamente, 
i blocchi che lo compongono devono essere concatenati fra loro. Questo 
significa che i primi due byte di ogni settore ancora residente in memoria 
devono contenere l’indirizzo T/S del blocco successivo. Una volta preparato 
il blocco, mandando in esecuzione PutBlock si trasferiscono i dati nel settore 
specificato. 

Di solito il blocco da trasferire è memorizzato nel buffer diskBIkBuf. 
PutBlock viene generalmente utilizzato aH’interno di un loop che individua il 
successivo settore libero su disco, aggiorna il puntatore T/S nel blocco 
ancora in memoria e chiama PutBlock per memorizzarlo nel settore 
correntemente libero (nota bene: il settore correntemente libero non è il 
successivo settore libero). 

Di solito si ricorre a PutBlock quando l’applicazione fa alcune variazioni nei 
codici contenuti in un blocco del file prelevato tramite GetBlock, e si deve 
riscrivere il blocco aggiornato su disco. Se si rende necessario aggiungere 
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uno o più blocchi a un file preesistente, l’applicazione deve utilizzare la 
routine NxtBIkAlloc, che fa riferimento alla BAM del disco, per allocare gli 
opportuni settori. L’indirizzo T/S del blocco successivo dev’essere 
memorizzato nella prima word di ogni blocco. PutBlock è una routine di livello 
intermedio e la sua utilità è probabilmente limitata alle applicazioni che 
vogliono realizzare funzioni di accesso al disco personalizzate. Normalmente 
le routine d’alto livello sono sufficienti a soddisfare quasi tutte le esigenze di 
questo tipo. 

Ecco un diagramma a blocchi che illustra le principali operazioni compiute 
da PutBlock: 

disabilita gli interrupt, 
disabilita gli aprite, 

attiva il codice turbo nel drive (se necessario lo trasferisce nel drive), 
scrive il blocco, 

disattiva il codice turbo nel drive, 
attiva gli aprite, e 
attiva gli interrupt. 

Il codice turbo residente nel drive mantiene il possesso del bus seriale, in 
modo che nessun altro dispositivo esterno possa accedere al bus mentre 
è in atto una comunicazione con il drive. 





Funzione: Carica il blocco File Header del file e lo memorizza nel buffer fileHeader. 


Indirizzo: $C229 

Chiamata da: LdFile, LdDeskAcc 

Chiama: GetBlock 

Parametri: r9 puntatore in memoria al File Entry del file, generalmente 

memorizzato nel buffer dirEntryBuf 

dirEntryBuf buffer che contiene il FNe Entry. Sebbene GetFHdrInfo non 
abbia bisogno dell’intero blocco nel quale è contenuto il File 
Entry interessato, questo viene ugualmente caricato in 
memoria dalla routine FindFile che GetFHdrInfo utilizza per 
ricercare il File Entry del file, e viene memorizzato nel buffer 
dìskBIkBuf 

Restituisce: r1 indirizzo T/S del primo blocco di dati del file ottenuto dal File 

Entry associato. Se il file è a struttura VLIR, questo primo 
blocco contiene la tavola indice dei record 
r7 indirizzo di caricamento del file, prelevato dal blocco File 

Header 

fileHeader buffer contenente il blocco File Header 
fileTrScTab i primi due byte contengono l’indirizzo T/S del blocco File 
Header su disco 

X codice d’errore da disco 

Distrugge: a, y, r4 

GetFHdrInfo legge l’indirizzo T/S del blocco File Header prelevato dal File 
Entry e lo memorizza nel buffer fileHeader. Aggiorna il registro r1 con 
i’indirizzo T/S del primo blocco del file, e restituisce in r7 l’indirizzo di 
caricamento del file. 


Sinossi: 






Funzione: Routine di livello intermedio utilizzata per leggere i dati contenuti in una 

concatenazione di blocchi su disco. I primi due byte di ogni blocco, cioè 
l’indirizzo T/S dei blocco successivo, non vengono ovviamente presi in 
considerazione durante la lettura dei dati. 

Indirizzo: $C1FF 

Chiamata da: LdFile, LdDeskAcc 

Chiama: EnterTurbo, InitForlO, ReadBlock, DoneWithIO 

Parametri: r7 Indirizzo a cui iniziare la memorizzazione dei dati 

r1L, r1H Indirizzo T/S del primo blocco del concatenamento 
r2 dimensione del buffer destinazione espressa in byte 

Restituisce: fiieTrScTab lista degli indirizzi T/S dei blocchi del file o del record. Un file 

può essere composto al massimo da 127 blocchi (32.258 
byte). GetFHdrlnfo memorizza nella prima word della tavola 
fileTrSc-Tab l’indirizzo T/S del blocco File Header del file. 
Quando si utilizza GetFile per caricare un file in memoria, viene 
eseguita la routine ReadFile per completare la tavola 
fileTrScTab 

X codice d’errore da disco; se il file è composto da un numero 

di blocchi che eccede le dimensioni del buffer (contenute in 
r2), GEOS restituisce in x l’errore BFR_OVERFLOW per 
indicare che sono stati oltrepassati i limiti di capienza del 
buffer. Se un blocco non può essere memorizzato interamente 
nel buffer, non viene letto. Se non si verifica nessun errore, 
GEOS restituisce 0 in x 

r7 punta in memoria la locazione che segue l’ultimo byte 

memorizzato 

r5L offset all’ultima word significativa memorizzata nella tavola 

fileTrScTab. Questa contiene l’indirizzo T/S dell’ultimo blocco 
letto da disco 

ri nel caso che i limiti di capienza del buffer siano stati 

oltrepassati, e si verifichi quindi l’errore BFR_OVERFLOW, ri 
contiene l’indirizzo T/S del blocco che non è stato letto 
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Distrugge: a, y, ri - r4 

Sinossi: ReadFile legge i dati contenuti in un file e li trasferisce in memoria. Mentre 

compie questa operazione, aggiorna anche la tavola fileTrScTab con gli 
indirizzi T/S dei blocchi letti. ReadFile viene mandata in esecuzione in seguito 
alia chiamata da parte dell'applicazione di una delie routine di caricamento 
d’alto livello, come GetFile. Per esempio, GetFile chiama LdFile che a sua 
volta chiama ReadFile per leggere un normale file a struttura SEQUENTIAL 
o anche a struttura VLIR. Nel caso di un file a struttura VUR, ri deve 
contenere l'indirizzo T/S del primo record. Prima di eseguire ReadFile, LdFile 
chiama GetFHdrInfo per leggere il File Header e memorizzarlo nel buffer 
fileHeader. Accedendo al File Header, LdFile preleva l’indirizzo T/S del 
blocco indice e carica in memoria la tavola indice del file a struttura VUR. 
Legge quindi dalla tavola l’indirizzo T/S del record desiderato e lo trasmette 
in ri a ReadFile, che a sua volta memorizza il contenuto di ri nel buffer 
fileTrScTab alla locazione fileTrScTab+2. fileTrScTab+2 individua la prima 
word libera dopo quella aggiornata da GetFHdrInfo, per memorizzarvi 
l’indirizzo T/S del primo record. 





Funzione: Trasferisce su disco una particolare area di memoria. I dati vengono salvati 

in una concatenazione di settori liberi già allocati per questa operazione. La 
routine verifica il corretto trasferimento di tutti i blocchi. 


Indirizzo: $C1F9 

Chiamata da: SaveFile 

Chiama: Il codice turbo di accesso al disco 

Parametri: r7 puntatore all’inizio dell’area di memoria da trasferire su disco 

r6 puntatore alla tavola di concatenamento dei blocchi allocati su 

disco per contenere il file (fileTrScTab) 

Preparazione 

dei drive: Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce: x codice d’errore da disco 

fileTrScTab la tavola degli indirizzi dei blocchi allocati su disco, inalterata 

Distrugge: a, y, r1, r2, r4, r6, r7 

Sinossi: WriteFile trasferisce su disco un’area di memoria specificata. Si tratta di una 

routine di livello molto basso ed è necessario che l’applicazione, prima di 
eseguirla, abbia aggiornato diverse variabili: il File Entry dev’essere già stato 
allocato dalle routine SetGDirEntry, BIdGDirEntry e/o GetFreeDirBIk, dev’es¬ 
sere già stata preparata la tavola fileTrScTab degli indirizzi T/S dei blocchi 
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che la routine può utilizzare per allocare il file, e i blocchi in essa indicati 
devono essere già stati allocati tramite la routine BIkAlloc. Ovviamente per 
compiere queste operazioni dev’essere già stato creato anche il blocco File 
Header. Oltre alla preparazione delle variabili significative, la routine WriteFile 
richiede solo che venga specificato il contenuto della tavola file!rScTab e dei 
registri r6 e r7. 

WriteFile trasferisce su disco i dati prelevati in memoria a partire 
dairindirizzo indicato in fi. Ogni volta che la routine preleva un blocco di 254 
byte dalla memoria, accede alla tavola fileTrScTab per leggere l’indirizzo T/S 
del successivo blocco allocato su disco. WriteFile crea il blocco da trasferire 
aggiungendo ai due byte che contengono l’indirizzo T/S i 254 byte che legge 
dalla memoria. Il blocco da 256 byte cosi ottenuto, viene infine memorizzato 
su disco. La traccia e il settore del blocco successivo vengono prelevati dal 
buffer fileTrScTab. WriteFile individua la fine dell’area di memoria da 
trasferire, scorrendo gli indirizzi T/S dei blocchi lungo la tavola fileTrScTab. 
Quando incontra un indirizzo T/S il cui primo byte è 0, WriteFile calcola 
(tramite il valore del secondo byte) qual è l’ultima locazione di memoria da 
trasferire. Infatti, un blocco che ha come primo byte 0 dev’essere l’ultimo 
della concatenazione e il secondo byte deve contenere il numero di byte 
significativi all’intemo del blocco. 
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ReadByte 


Funzione: Permette di prelevare, a un ritmo di un byte alla volta, i dati memorizzati in 

una concatenazione di blocchi su disco. I registri r1, r4, r5 e il buffer allocato 
per l’operazione non devono essere alterati durante la sequenza di chiamate 
a questa routine, finché non sono stati prelevati tutti i dati. 

Indirizzo: $C2B6 

Chiama: GetBiock 


Parametri: Solo alla prima chiamata: 

r1 indirizzo T/S del primo blocco da leggere 

r4 puntatore a un buffer da 256 byte, di solito diskBIkBuf 

r5 0, indice al prossimo byte da leggere inizializzato a 0 per la 

prima chiamata 

Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 

BAM del disco corrente dev'essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 


Restituisce: r1 
r4 
r5 

X 


a 

Z 


Distrugge: y 


indirizzo T/S del successivo blocco da leggere 
inalterato 

incrementato, indice al successivo byte da leggere 
codice d’errore da disco (“nessun errore” restituisce x = 0) 
Quando si verifica l’errore BFR_OVERFLOW, significa che la 
routine ha restituito l’ultimo byte del concatenamento di 
blocchi 

il byte dato prelevato dal file 

il flag Z nel PSW è impostato a 1 se il registro x è diverso da 
0; in questo modo si rende più rapido il controllo sull’eventuale 
presenza di un errore 
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Sinossi: 


ReadByte permette all’applicazione di ricevere uno alla volta i byte contenuti 
in una concatenazione di blocchi su disco. In realtà l’input dei dati da disco 
è ancora a blocchi^ ma questi vengono memorizzati uno alla volta in un 
buffer. ReadByte, richiamata periodicamente dall’applicazione, accede al 
buffer e lo svuota, caricando quindi il blocco successivo. Sia i file a struttura 
SEQUENTIAL sia quelli a struttura VUR possono essere letti attraverso 
questa routine. L’applicazione deve specificare l’indirizzo T/S del primo 
blocco da leggere e chiamare ReadByte per ottenere il primo byte. Per 
ottenere il successivo, l’applicazione deve chiamare nuovamente ReadByte 
e cosi via. Quando si verifica l’errore BFR_OVERFLOW, significa che la 
routine ha cercato di leggere un byte dopo la fine del file, e quindi che la 
precedente chiamata alla routine aveva restituito l’ultimo byte del concatena¬ 
mento. 





Funzione: Preleva la Directory Header e la BAM del disco, contenute nel Directory 

Header Block, e le trasferisce in memoria. In pratica la routine trasferisce il 
contenuto del blocco collocato a traccia 18 e settore 0 della directory. 

Indirizzo: $C247 

Chiamata da: OpenDisk, SetGEOSDisk, BIkAlloc, FreeFile, FastDelFile 

Chiama: GetBlock 

Parametri: curDrive questa variabile globale contiene il valore 8 o 9 per indicare il 

drive correntemente attivo. Il drive indicato dev’essere il 
dispositivo che utilizza in quel momento il bus seriale, ovvero 
quello selezionato tramite SetDevice, e dev’essere inizializzato 
tramite una chiamata a NewDisk o a OpenDisk (OpenDisk 
chiama a sua volta NewDisk) 

Restituisce: curDirHead questo buffer contiene il Directory Header Block del disco 

corrente 

Distrugge: a, x, y, ri, r4 

Sinossi: GetDirHead legge dal disco corrente il Directory Header Block, che 

comprende anche la BAM, e lo memorizza a curDirHead. La routine 
SetDevice dev’essere già stata chiamata per aggiornare curDrive con il 
numero del drive che si vuole attivare cedendogli il bus seriale. Inoltre 
dev’essere già stata eseguita la routine NewDisk (oppure OpenDisk), cioè 
il drive deve già essere stato preparato per accedere al disco 
Per questa routine sono previsti alcuni miglioramenti che dovrebbero 
renderla compatibile con qualsiasi tipo di drive, come per esempio la 
capacità di accedere a BAM di diverso formato. GEOS conserva una copia 
della BAM in memoria mentre alloca e disalloca blocchi su disco. I 
cambiamenti di stato dei blocchi sul disco sono riportati nella copia della 
BAM in memoria. Quando sono state operate le dovute variazioni, la copia 
aggiornata della BAM dev’essere riallocata sul disco tramite la routine 
PutDirHead. È per questo che l’utente non dovrebbe mai rimuovere il disco 
dal drive durante gli accessi. Se la nuova BAM non viene riallocata, il disco 
è da considerare parzialmente rovinato, anche se non in maniera definitiva. 
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PutDirHead 


Funzione: Rialloca su disco la copia del Directory Header Block conservata in memoria. 

Indirizzo: $C24A 


Chiamata da: SaveFile, FreeFile, FastDelFile, SetGEOSDisk 


Chiama: PutBlock 

Parametri: curDirHead una copia valida del Directory Header Block per il disco 

corrente 

curDrive questa variabile globale contiene il valore 8 o 9 per indicare il 
drive correntemente attivo. Il drive indicato dev’essere il 
dispositivo che utilizza in quel momento il bus seriale, ovvero 
quello selezionato tramite SetDevice, e dev’essere inizializzato 
tramite una chiamata a NewDisk o a OpenDisk (OpenDisk 
chiama a sua volta NewDisk) 

Restituisce: disco il Directory Header Block su disco aggiornato con la copia 

memorizzata a curDirHead 


Distrugge: a, x, y, r0-r15 


Sinossi: Scrive su disco il Directory Header Block correntemente memorizzato nel 

buffer curDirHead. PutDirHead, in seguito, sarà in grado di trasferire su disco 
tutte le porzioni delle BAM di drive di diverso tipo. 
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NewDisk 


Funzione: 

Indirizzo: 

Chiamata da: 

Chiama: 

Parametri: 

Restituisce: 


Trasferisce la BAM del disco corrente nella memoria interna del drive. 

$C1E1 

OpenDisk 

EnterTurbo, InitForlO, DoneWithIO 

curDrive deve contenere il numero del drive corrente 

drive nella memoria del drive è residente la BAM del disco corrente 

X codice d’errore da disco 


Distrugge: a, y, ri 

Sinossi: li disk drive 1541 memorizza il byte d’identificazione ID del disco corrente 

nella sua memoria interna. Quando l’utente inserisce un nuovo disco nel 
drive, il nuovo byte ID dev’essere memorizzato dallo stesso drive prima di 
qualunque altra operazione. NewDisk ordina al drive di leggere la BAM del 
disco appena inserito. Il drive dovrebbe già essere in ascolto sul bus seriale. 
Subito dopo SetDevice, che mette in condizione “di ascolto” il drive, 
generalmente viene chiamata NewDisk. 

Se il codice turbo all’intemo del drive non è in esecuzione, la routine lo 
installa e lo lascia in esecuzbne. NewDisk è una subroutine di OpenDisk. 
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LdApplic - Carica l’applicazione 


Funzione: Carica ed esegue un’applicazione GEOS compatibile. 

Indirizzo: $C21D 

Chiamata da: GetFile 
Chiama: LdFile 


Parametri: i9 

lOL 


r2 e r3 


r2 


puntatore al File Entry del file (generalmente memorizzato nel 
buffer dirEntryBuf) 
flag IoadOpt 
bit 0 

0 segue la procedura standard di caricamento 
1 carica il file all’Indirizzo specificato in r7 (la 
costante per questo bit è ST_LD-AT-ADDR) 
bit 6 (solo per file eseguibili) 

0 il file non è stato selezionato per essere stampato 
direttamente 

1 deskTop, per esempio, imposta a 1 questo bit quando 
l’utente muove l’icona di un file dati sopra l’icona della 
stampante e preme il pulsante del mouse. L’applicazio¬ 
ne stampa il file e conclude la sua esecuzione (la 
costante per questo bit è ST-PFLDATA) 
bit 7 (solo per file eseguibili) 

0 non è specificato alcun file dati 
1 l’applicazione da caricare è quella che ha creato il file dati 

selezionato dall’utente per essere subito elaborato (la 
costante per questo bit è ST-LD_DATA) 
vengono passati solo se; 

1) dev’essere caricata un’applicazione 

2) il bit 6 o il bit 7 in rOL (o entrambi) sono impostati a 1 
puntatore al nome del disco che contiene il file dati che 
l’applicazione deve elaborare automaticamente, li registro r2 e 
il contenuto del buffer dataDiskName vengono passati 
all’applicazione. Questa, una volta che è stata caricata e 
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Preparazione 
del drive: 


Restituisce: 


mandata in esecuzione, elabora il file dati come specificato nel 
bit 6 di IoadOpt 

r3 punta ai buffer che contiene il nome del file dati. L’applicazione 

utilizza questo puntatore per caricare il file dati in memoria ed 
elaborarlo automaticamente. r3 e il contenuto del buffer 
dataFileName vengono passati all’applicazione. Questa, una 
volta che è stata caricata in memoria e mandata in esecuzione, 
elabora il file dati come specificato nel bit 6 di IoadOpt 

r7 contiene l’indirizzo al quale il file dev’essere memorizzato in 

memoria se il bit 0 in rOL, individuato da ST_LD-AT_ADDR, è 
impostato a 1 


Per accedere ai disco con successo, il drive dev’essere inizializzato. Il byte 
d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine d’alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi ai 
disco. 

Restituisce l’applicazione in memoria. Se il file è a struttura VLIR la routine 
carica in memoria il primo record. Se il flag IoadOpt non specifica la richiesta 
di un rilocamento del file a una particolare zona di memoria, LdApplic 
inizializza il sistema a uno stato di defauit ed esegue l’applicazione. La routine 
in questo caso non restituisce il controllo al codice che l’ha chiamata. 
Quando invece IoadOpt richiede espiicitamente un rilocamento del file a un 
indirizzo diverso da quello indicato nel blocco File Header, LdApplic, dopo 
aver caricato il file in memoria all’indirizzo indicato da r7, restituisce il controllo 
al codice che l’ha chiamata, perché non avrebbe senso mandare in 
esecuzione un’applicazione che è stata caricata a un indirizzo diverso da 
quello dove normalmente viene collocata. Sarebbe molto improbabile che 
funzionasse ugualmente 

r7 IoadAddr, contiene l’indirizzo d’esecuzione (start address) 

prelevato dal blocco File Header 
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r2, r3 e rO vengono passati all’applicazione o all’accessorio da scriva¬ 
nia 

r5L offset dall’inizio del fileTrScTab all’ultima word significativa 

per il file 

dataDiskName inalterato 
dataFileName inalterato 
dirEntryBuf inalterato 


X codice d’errore da disco: se il file è composto da più di 127 

blocchi, si verifica l’errore BFR-OVERFLOW e non viene 
letto il blocco 128. La presenza di un qualsiasi errore da 
disco costringe la routine LdApplic a restituire il controllo al 
codice che l’ha chiamata 

ri nel caso si verifichi l’errore BFR-OVERFLOW, ri contiene 

l’indirizzo T/S del blocco che non è stato letto. 

LdApplic effettua una partenza “a caldo” del sistema. Per 
maggiori dettagli consultare la configurazione di sistema in 
partenza “a caldo" illustrata nel capitolo 20 

Distrugge: Tutti gli pseudoregistri che non sono citati tra i parametri restituiti. Se non è 

specificato alcun rilocamento forzato, e se non si verificano errori, la routine 
LdApplic non restituisce il controllo al codice che l’ha chiamata 

Sinossi: LdApplic viene chiamata da GetFile per caricare ed eseguire un’applicazione 

GEOS compatibile. Prima di chiamare LdApplic, GetFile chiama la routine 
FindFile. Quindi, normalmente, LdApplic dipende dalie variabili impostate da 
FindFile. Ci sono tre motivi perché un’applicazione debba essere caricata in 
memoria: 

1 ) l’utente ha selezionato l’applicazione da deskTop, e questa dev’essere 
eseguita come di consueto 

2) l’utente ha selezionato da deskTop un file dati, e l’applicazione 
dev’essere caricata ed eseguita per elaborarlo automaticamente 

3) l’applicazione dev’essere eseguita per stampare automaticamente un 
file dati e subito dopo deve restituire il controllo a deskTop. 

Per indicare quale tra questi è il motivo per cui l’applicazione è stata 
caricata ed eseguita, viene passato a LdApplic il flag IoadOpt. Se 
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l’applicazione è stata eseguita in seguito alla selezione di un file dati o alia 
richiesta di stampa di un file dati, la routine c^e esegue la chiamata (di solito 
desklop) deve passare il nome del file dati e del disco sul quale è residente. 
Poi l'applicazione deve leggere il contenuto del flag IoadÒpt e operare di 
conseguenza. 

Grazie a LdApplic è possibile anche caricare un file in memoria a un 
indirizzo diverso da quello consueto. Questa opzione sen/e più che altro per 
i file dati, dal momento che è improbabile che un’applicazione venga 
realizzata con codici tilocabili e quindi che sìa eseguibile in qualunque area 
della memoria. Se LdApplic si trova a caricare un file a un indirizzo diverso 
da quello specificato nel blocco File Header, a operazione ultimata restituisce 
il controllo al codice di chiamata. Sarebbe del resto assurdo mandare in 
esecuzbne un’applicazione rflocata a un indirizzo arbitrario. Si deve inoltre 
evitare che l’applicazione caricata, e rilocata a un diverso indirizzo, vada a 
sovrapporsi al codice di chiamata, perché altrimenti LdApplic si troverebbe 
a restituire il controllo a un codice diverso da quello di chiamata. 





Funzione: Carica un file in memoria. 


Indirizzo: $C211 

Chiamata da: GetFiie, LdApplic 

Chiama: GetFHdtlnfo, ReadRIe 

Parametri: r9 puntatore al File Entry, memorizzato nel buffer dirEntryBuf 

rOL flag IoadOpt per la selezione delle opzioni di caricamento 
bit 0 

0 segue le informazioni di caricamento memorizzate nel 
blocco File Header 

1 carica il file all’Indirizzo specificato in IoadAddr (r7). La 
costante per questo bit è ST_LD_AT_ADDR 
r7 IoadAddr; parametro opzionale. Se il bit ST_LD-jM-AìDDR è 

impostato a 1 in IoadOpt, IoadAddr dovrebbe contenere l’indirizzo di 
caricamento per il file 

Preparazione 

del drive Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 
d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce: Il file caricato in memoria. Il controllo viene restituito al codice di 

chiamata 

IoadOpt il flag per le opzioni di caricamento resta inalterato 

IoadAddr l’indirizzo di caricamento alternativo resta inalterato 

fileTrScTab+2 lista degli indirizzi T/S dei blocchi che compongono il file o 





ROUTINE DI LIVELLO INTERMEDIO 


323 


Distrugge: 

Sinossi: 


il record. Il numero massimo di blocchi che possono 
comporre il file, o il record, è 127 (32.258 byte). GetFHdrinfo 
memorizza nella prima word del buffer fileTrScTab l’indirizzo 
T/S del blocco File Header del file. Di conseguenza, quando 
viene impiegata GetFile per caricare un file, dev’essere 
eseguita anche ReadFile per completare la tavola fileTrSc¬ 
Tab. Se il file è a struttura VUR, le word che nel buffer 
seguono la prima contengono gli indirizzi T/S dei blocchi che 
compongono il primo record 

X codice d’errore da disco: se si verifica l’errore 

BFR-OVERFLOW, il file è troppo lungo. Il blocco che 
oltrepassa il limite non viene letto 

r7 punta in memoria il byte successivo all’ultimo memorizzato 

r5L offset dall’inizio del buffer fileTrScTab all’ultima word 

significativa per il file 

ri se si verifica l’errore BFR-OVERFLOW, ri contiene l’indirizzo 

T/S del blocco che non è stato letto perché oltrepassava i 
limiti 


a, X, y, rO - rIO 


LdFile viene di solito chiamata dai codici interni di GEOS per caricare un file 
di sistema come deskTop. Diversamente da GetFile, che carica e manda in 
esecuzione il file, LdFile, a caricamento ultimato, restituisce sempre il 
controllo al codice che ha effettuato la chiamata. GetFile utilizza LdFile 
quando deve caricare in memoria un file non eseguibile. 

LdFile utilizza il File Entry del file per caricare il blocco File Header e 
prelevare le informazioni necessarie per caricare il file. Informazioni che sono 
inutili se il bit 0 del flag IoadOpt è impostato a 1. In questo caso, infatti, 
l’indirizzo di memoria al quale inizia il trasferimento del file dev’essere 
indicato in IoadAddr. 

Se il file è a struttura VUR, viene caricato in memoria solo il primo record 
(il record 0). Le opzioni di caricamento previste da LdFile sono valide anche 
in questo caso. 





LdDeskAcc - Carica il desk accessory 


Funzione: Questa routine manda in esecuzione un desk accessory. Il desk accessory 

è un’applicazione che viene eseguita in modo completamente indipendente 
da qualunque ambiente di lavoro. La sua esecuzione, agli occhi 
dell’applicazione che l’ha mandata in esecuzione, è completamente 
trasparente e non altera minimamente l’ambiente di lavoro precedente alla 
chiamata di LdDeskAcc. 

Indirizzo: $0217 

Parametri: r9 puntatore al File Entry, memorizzato nel buffer dirEntryBuf 

rOL flag IoadOpt per la selezione delle opzioni di caricamento 
bitO 

0 segue le informazioni per il caricamento memorizzate nel 
blocco File Header 

1 carica il file all’indirizzo specificato in IoadAddr (r7). La 
costante per questo bit è ST-LD.^T_ADDR 
r7 IoadAddr: parametro opzionale. Se il bit ST-LD-AT_ADDR è 
impostato a 1 in IoadOpt, IoadAddr dovrebbe contenere l’indirizzo di 
caricamento per il file 

Preparazione 

del drive: Per accedere al disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID del disco dev’essere memorizzato nella RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispxjsitivo del 
drive corrente, e viene aggiornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabili necessarie sono 
già state impostate o aggiornate da routine di alto livello. Dal momento che 
scendendo di livello le routine diventano molto più rapide nell’esecuzione, in 
questo modo il programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restituisce: Niente 

Distrugge: a, x, y, rO - rio 
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Sinossi: 


LdDeskAcc viene chiamata per mandare in esecuzione un accessorio da 
scrivania (desk accessory). Prima di svolgere questa operazione, Ld- 
OeskAcc salva tutte le variabili globali che caratterizzano l’ambiente di lavoro 
corrente, comprese le variabili interne di gestione dei menu e delle icone. È 
un’operazione che preserva l’ambiente di lavoro corrente e permette 
all’occorrenza di ripristinarlo senza difficoltà. Per sapere con certezza quali 
aree della memoria vengono salvate durante l’esecuzione di un desk 
accessory, si consulti la Memory Map riportata in appendice. 

Gli accessori da scrivania possono essere allocati in qualunque punto 
della memoria disponibile alle applicazioni e possono essere anche di 
dimensioni molto grandi. GEOS, prima di caricare in memoria il desk 
accessory, provvede a controllare le sue dimensioni e il suo indirizzo di 
caricamento. Queste informazioni sono necessarie per poter memorizzare 
su disco, in un file di tipo TEMPORARY (di solito chiamato “swap file"), l’area 
di memoria che viene sovrascritta dal desk accessory, in modo che alla sua 
chiusura possa essere correttamente riallocata. È per questo che i desk 
accessory possono essere eseguiti esclusivamente se il Kernel riesce ad 
accedere al disco e a memorizzarvi l’area di memoria che viene sovrascritta. 

Un accessorio da scrivania dev’essere considerato come un’applicazio¬ 
ne, con l’unica limitazione che non può andare a scrivere in aree della 
memoria non comprese in quella che occupa, e non può chiamare altri desk 
accessory né aprire box di dialogo. Può però creare qualunque struttura di 
dati su disco, impiegare menu e icone proprie, come una normale 
applicazione. 

Quando l’accessorio da scrivania conclude la sua esecuzione, non deve 
far altro che eseguire l’istruzione jmp RstrAppI, in modo che il Kernel 
provveda a ripristinare interamente la configurazione precedente all’apertura 
del desk accessory. Il controllo viene restituito al axlice che ha richiesto 
l’esecuzione del desk accessory. 

LdDeskAcc, oltre a salvare in una particolare area della memoria di 
sistema l’ambiente di lavoro corrente, provvede anche a ripristinare con gli 
appropriati valori di default alcune locazioni di memoria. Nella pagina 
successiva è riportata una lista delle aree salvate e delle variabili riportate allo 
stato di default. Ricordiamo che lo stesso vaie per i box di dialogo: le aree 
di memoria salvate prima di aprire un DA sono le stesse che vengono salvate 
prima di aprire un BD, le variabili riportate a uno stato di default prima 
dell’apertura di un DA sono le stesse che vengono riportate a uno stato di 
default prima di aprire un BD. 
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Variabili globali salvate prima dell’apertura di un desk accessory o di un 
box di dialogo, e ripristinate alla chiusura: 

da cunrPattern ($0022) a lightMargin ($0037) compresa 
da appMain ($849B) a stringY ($84C0) compresa 
graphicsMode ($003F) 
da spritePointers ($8FF8) a $8FFF compresa 
da vicBase ($D0(X)) a msbxpos ($D010) compresa 
mobenble ($D015) 

da mobprior ($D01B) a mobx2 ($[D01D) compresa 
da mcmcIrO ($D025) a mcmcirl ($0026) compresa 
da mobicir ($0027) a mob7clr ($O02E) compresa. 

Variabili riportate a uno stato di default prima dell’apertura di un desk 
accessory o di un box di dialogo: 

da currentMode ($002E) a pressFlag ($0039) compresa 
da appMain ($849B) a faultOata ($84B6) compresa 
da spritePointers ($éFF8) a $8FFF compresa. 


I valori di default per queste variabili si possono trovare nel capitolo 20. 





Funzione: Questa è la routine che dev’essere eseguita dai desk accessory quando 

terminano l’esecuzione. 


Indirizzo: $C23E 

Parametri: Nessuno 

Restituisce: L’area di memoria precedentemente salvata su disco, riallocata 
Distrugge: In linea di massima, tutti i registri 

Sinossi: Questa è la routine che l’accessorio da scrivania deve eseguire, tramite 

l’istruzione jmp RstrAppI, quando conclude la sua esecuzione. Questa 
routine provvede a ricaricare da disco l’area di memoria precedentemente 
salvata, a cancellare il file di tipo TEMPORARY presente su disco e a 
ripristinare la situazione precedente alla chiamata di LdDeskAcc. Per una 
lista delle aree di memoria ripristinate da RstrAppI, si consulti la descrizione 
della routine LdDeskAcc. 





GetFreeDirBIk - Alloca lo spazio per un File Entry 


Funzione: Indicando una certa pagina della directory, questa routine trova io spazio 

libero per memorizzarvi il File Entry di un file. Essa non effettua nessuna 
variazione sui disco, ma predispone le opportune variabili per la creazione 
del File Entry. Se la pagina richiesta non ha spazi iibeii, la routine cerca uno 
spazio adatto nelle pagine seguenti. 

Indirizzo: $C1F6 

Chiamata da: SetGDirEntry 

Chiama: GetDiskBlock, AddDirBIock 

Parametri: r10L numero della pagina della directory aH'interno della quale la 

routine inizia la ricerca di uno spazio libero in grado di contenere 
un File Entry 

curDirHead contiene il Directory Header Block del disco corrente 

Restihiisce: x codice d’errore da disco 

diskBIkBuf contiene il blocco della directory airinterno del quale la routine 
ha trovato uno spazio libero 

y contiene un indice, riferito all’inizio del blocco della directory 

memorizzato nel buffer diskBIkBuf, che punta allo spazio 
disponibile nella pagina per contenere un File Entry 
r1 OL contiene il numero della pagina della directory entro la quale la 
routine ha trovato io spazio richiesto 

curDirHead contiene il Directory Header Block aggiornato. Attenzione: se la 
routine ha dovuto allocare un nuovo blocco per la directory, nei 
caso che le pagine già aliocate fossero tutte piene, diventa 
necessario riscrivere il contenuto del buffer curDirHead su 
disco, in quanto ia routine aggiorna anche la BAM 

Distrugge: a, x, y, rO - r1, r3, r5, r7, r8 

Ogni pagina del bloc notes raffigurato in deskTop corrisponde a un blocco 
della directory (una pagina in deskTop non può contenere più di otto icone 
e un blocco della directory non può contenere più di otto File Entry). Il valore 
passato in r10L indica il numero della pagina all’intemo della quale la routine 


Sinossi: 
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prova a cercare lo spazio per un nuovo Rie Entry (r10L - 4 ìndica la psgina 
quattro del bloc notes di deskTop). 

Se non c’ò spazio neUa pagaia ricNesta, GetFreeOirBIk estende la ricerca 
alle pagine successive della directory (i blocchi della directory sono 
concatenati in sequenza come i file normali). Se necessario, GetFreeOvSik 
alloca un nuovo blocco per la directory. Se tutti i 18 blocchi di cui la directory 
può potenzialmente disporre sono pieni, la routine restituisce un flag 
d’errore. 

Se l’applicazione richiede lo spazb per un Rie Entry in una pagina non 
ancora allocata e non contigua a quelle già utilizzate (per esonpio, la 
directory arriva sino a pagina 4 e l’applicazione richiede che la ricerca venga 
svolta a pagina 10), la routine alloca le necessarie pagine bianche da 
aggiungere alla directory in modo da rendere disponibile la pagina 
desiderata. 





Funzione: Alloca sino a 127 blocchi su disco per creare lo spazio necessario al 

salvataggio di un file. 

Indirizzo: $C1FC 


Chianiata da: SaveFile, WriteRecord 

Chiania: CateBiksFree, SetNextFree 

numero di byte per i quali la routine deve allocare spazio sul 
disco. Il numero massimo è 32.258 
puntatore all’inizb del buffer da utilizzate per memorizzare la 
tavola degli indirizzi T/S dei blocchi generata dalia routine. Di 
solito questo buffer viene allocato a fileTrScTab, o fileTrScTab 
+ 2 se si utilizza la prima word per puntare il nome del file 
contiene il Directory Header Block corrente. Per creare questa 
informazione si utilizza GetDirHead 
questa variabile globale fissa il numero di blocchi di 
separazione fra un blocco e il successivo quando la routine 
alloca i settori del disco. Impostarìdo opportunamente il 
numero di settori da saltare fra la memorizzazione di un blocco 
e il successivo si può raggiungere una grande efficienza. Per 
le routine di scrittura del turbo del 1541 il numero più adatto è 
otto. Con un interieave di otto settori si ottiene la massima 
velocità di salvataggio dei dati e questa scelta è tanto più 
conveniente quanto più vasti sono i gruppi di dati con cui si 
lavora. Non risulta invece molto efficiente per le routine di 
lettura del turbo. Per i file che devono essere letti frequente¬ 
mente, l’interleave che rende massima l’efficienza è 9. Questo 
natura^ente danneggia l’efficienza nelle procedure di scrittu¬ 
ra, e si deve quindi fare una scelta diversa caso per caso. 
GEOS imposta la variabile globale interieave con il valore di 
default 8 

Restituisce: r2 numero di blocchi allocati 

r3 indirizzo T/S dell’ultimo blocco allocato 

X codice d’errore da disco 
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Distrugge: 

Sinossi: 


0 roperazime ha avitto successo 

INSUFF-SPACE questo errore indica che sul disco non 
sono pr^enti abbastenza blocchi lìberi. Se 
si verifka un errore da disco, di qualsiasi 
tipo, la routine int^orr^ la propria esecu¬ 
zione, registrando le modifiche fatte fino ad 
aOora nella cof:^ deftaBAM memorizzata in 
curfMiead. Dal momento che la routine 
agisce sulla copia ctella BAM in memoria e 
non trasf^’^tece il Drectory Header Blod< 
nuovamente su disco, le s^icazionj pos¬ 
sono anche utilizzarla per sapere in antìci¬ 
po se vi »xio abbastanza blocchi liberi su 
dteco 

curOirHead la BAM contenlrta nella copia del Directory Header Block, 
memorizzata nel buffer curDirHead, viene restituita con 
raggkxnamento sui nuovi settori alkx^tì. Sino a questo 
momento il disco non ha subito alcuna variazione, dai 
momento che la routine non riscrive su disco la nuova BAM. 
É compito deH'E^icas^one, dopo l'esecuzione di BikAlloc, 
riscrivere su disco l'intea’o Directory Head» Block tramite la 
routine PutDirHead 

fileTrScTab la routine ripcxta in questa tavola gli fricSrizzi T/S dei settori che 
ha allocato sulla copia della BAM in memoria. Questa tavola è 
puntata da r6 prima dett’esecuzione ctaHa routine e quindi può 
anche trovarsi a un indirizzo diverso da ftelrScTab 
r8L numero di byte che andranno memorizzati nell’ultimo blocco 

r6 puntatore aR'inizio dei buffer che contiene la tavola degli 

indirizzi T/S dei blocchi allocati (inalbato) 


a, X, y, r4 - r5 


BikAlloc sì utilizza per stabilire una concatenazione di blocchi aibcabile su 
disco. Attenzione; la routine non li alloca realmente e lascia inalterata la BAM 
del disco. Essa altera esclusivamente la copia della BAM mantenuta in 
memoria e aea il percorso delta concatenazione. Tramite questa routine le 
applicazioni possono sapere in anticipo quanto spazio è disponibile su disco 
per un determinato file. Il percorso d^a concatenazione, cioè gii indirizzi T/S 
dei blocchi ailocabìli, è memorizzato nel buffer puntato da r€ (gen»almente 
questo buffer è fileTrScTab). 
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BtkAiloc kvm la ricerca dei blocchi allocali part^Kio dalla traccia 1, e si 
muove verso la traccia 35. Nei corso della ricerca, la traccia 18 viene 
ignorata. La routine cerca di allocare i blocchi (nefe copia defla BAM), 
mantenendo fra i settori l’interieave stabilito dall’applicazione. Una buona 
scelta deirintedeave accresce la velocità d’accesso ai disco. Prima di 
allocare i settori (neHa copia delia BAM), la routine si assicura che ci sia 
abbastanza spazk> sul di^. 

La pr^a word pimtata da f6, di solito fileTrScTab+2, a operazione ultimata 
contiene l’indirizzo T/S dei primo blocco Itoero aHocato (la routine non attera 
r6, in modo che l’appKcazione possa utilizzarlo ancora). La seconda v^d 
individua l’incfirizzo T/S del secondo blocco libero allocato, e cosi via Le 
routine che utilizzano questa tavola di indirizzi T/S per trasferire dati su disco, 
memorizzano rei primi due byte dei blocco l’indirizzo T/S del blocco 
successivo in modo da creare una concatenazione di blocchi conforme allo 
standard del disk drive 1541. BikAHoc, dopo aver memorizzato nel buffer 
l’indrizzo T/S deH’utthno bkxxjo, scrive nella word successiva il valore 0 e il 
nLmero dei byte significativi ccmtenuti neli’ultimo blocco. 

Ricordemo ancora come operano le routine di salvataggio dei dati quando 
completano la memorizzazione su cfisco dell’ultimo blocco (aH’indirizzo 
specificato dalia tavola dei blocchi concatenati, come può essere per 
esemplo fileTrScTab). Scrivono, nei primi due byte di questo blocco, il 
contenuto della word che segue l’ultimo indirizzo T/S nella tavola dei blocchi 
adiocati; nei due byte della word sono contenuti rispettivamente uno 0 per 
indiove che non segarono altri blocchi, e un numero che indica quanti sono 
i byte significativi memorizzati neii’Ldtimo blocco. 

BIkAiioc è in grado di allocare su disco un massimo di 127 blocchi alla volta 
(32.258 byte). Nel caso in cui l’applicazione abbia bisogno di aggiungere dati 
a un ffie, o record, già memorizzato su cfeco, si rende necessario utilizzare 
la routrie NxtBIkAitoc, che aggiunge blocchi a un file. 
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NxtBIkAlloc 


FunxkNM: CH^ta routine ha la stessa ftflizbne di BtkAiloc, con la differenza che 

permette di spedfk^e da quale settore del disco dev'esso-e iniziata la 
ricerca dei settori Uberi. È una caratteristica che si può sfruttare per 
aumentare le dimensioni di file già residenti su disco, mantenendo l’interleave 
ottimale fra i settori. 


Indirizzo: $C240 


Chiama: CaicBIksFree, SetNextFree 


Paramatri: 


r3 


r2 

t6 


curDirHead 

interleave 


l’indRlzzo T/S del settore dal quale la routine, aggiungendo 
t’interleave, inizia a cercare H primo settore lk)ero aHocabile. Di 
solito r3 contiene l’indirizzo T/S dell’ultimo blocco allocato in 
una preesistente concatenazione su disco 
numero di byte per i quali la routine deve allocare spazio su 
disco. R valore massnio ammesso è 32.258 
puntatore all’inizio dei buffer che contiene la tavola degli 
indirizzi T/S dei blocchi allocabiii generata dalla routine (r6 di 
norma punta il buffer ffleTrScTab) 
contiene H Directory Header Block corrente. È necessario 
utilizzare la routrie GetDirHedd per leggerlo da disco 
questa variabile ^obale fissa H numero di blocchi di 
separazkxie fra un blocco e il successivo quando la routine 
alloca i settori del disco. Impostando opportunamente il 
numero di settori da saltare si può rag^ngere izia grande 
efficienza. Per le routine di scrittura del turbo del 1541 il numero 
più acfettto è otto. Con un interieave di otto settori si ottiene la 
massima velocità di salvataggio dei dali e qu^ta scelta è tanto 
più conveniente quanto più vasti sono t ^iippi di dati con cui 
si lavora. Non risirtta invece molto efficiente per le routine di 
lettura del turbo. Per i file che devono essere letti frequente¬ 
mente, l’interieave che rende massima l’efficienza è 9. Questo 
naturalmente danneggia l’efficienza nelle procedure di soittu- 
ra, e si deve qtwidi fare una scelta diversa caso per caso. 
GEOS imp(^ la var^sile gkbale interleave con il vakxe di 
default 8 
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Restituisce: 


Dietrugge: 

Sinossi: 


r2 

r3 

X 


curDIrHead 


fileTrScTab 


r8L 


numero di blocchi allocati 

indirizzo T/S dell’ultimo blocco libero allocato 

codice d’errore da disco 

0 l’operazione ha avuto successo 

INSUFF-SPACE questo errore indica che sul disco 

non sono presenti abbastanza bloc¬ 
chi liberi. Se si verifica un errore da 
disco, di qualsiasi tipo, la routine 
interrompe la propria esecuzione, 
registrando le modifiche fatte fino ad 
allora nella copia della BAM memor 
rizzata in curDirHead. Dai momento 
che la routine agisce sulla copia 
della BAM in memoria e non trasferi¬ 
sce il Directory Header Block nuova¬ 
mente su disco, le applicazioni pos¬ 
sono anche utilizzarla per sapere in 
anticipo se vi sono abbastanza 
blocchi liberi su disco 

la BAM contenuta nella copia del Directory Header Block, 
memorizzata nel buffer curDirHead, viene restituita con 
l’aggiomamento sui nuovi settori allocati 
la routine riporta in questa tavola gli indirizzi T/S dei settori che 
ha allocato suMa copia della BAM in memoria. Questa tavola è 
puntata da r6 prima dell’esecuzione della routine e quindi può 
anche troverai a un indirizzo diverso da fileTrScTab 
numero di byte che saranno memorizzati nell’ultimo blocco 


a, X, y, rO - r5 

NxtBIkAlloc vier« normalmente utilizzata per allocare nuovi blocchi su disco 
da aggiungere a una concatenazione preesistente. NxtBIkAHoc riceve tra i 
perametri l’indirizzo T/S dell’ultimo bkxxx) file, o del record, e da questo 
punto mia la ricerca dei settori liberi (creando la tavola degli indirizzi T/S dei 
bloccò addizionaiì). ^gkxna Irìoltre la copia della BAM menrìorizzata nei 
buffer curDirHead. Durante la ricrea dei blocchi liberi, la traccia 18 viene 
ignorata. NxtBIkAUoc, come BikAHoc, non produce syeuna variazione su 
disco. È compito d^’appHcazione, dopo l’esecuzione della routine, 
rìscriveiB la nuova BAM su ^dnoo tramite la routine PutDirHead. 

Come avviene p^ Bik^oc, NxtBIkAHoc è in grado di allocf^e un massimo 
di 127 blocchi alla volta (32.258 byte). Per maggiori dettagli si riveda la 
descrizione di BIkAlloc. 
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SetNextFree 


Funzione: La routine riceve in input l’indiiizzo T/S di un biocco e il valore deH’interieave 

fra settori, trova H blocco e lo contrasse^ come allocato nella copia delia 
BAM mantenuta nei buffer dirCuit-lead. 

IndMzzo: $C292 


CMamatada: BIkAlloc, NxtBIkAlloc, SetGEOSDisk 

Peramotrf: r3 indirizzo T/S del blocco dal quale la routine inizia la ricerca dei 

successivo settore libero. Se l'indirizzo T/S indca la traccia 18, 
la routine sa che deve allocare un blocco per la directory e 
limita la ricrea esclusivamente alla traccia 18. in caso 
contrario questa traccia è completamente ignorata dalia 
routine net cr^so della ricerca 

curDirHead deve contenere il Directory Header Block del disco, dove si 
trova la copia della BAK4 su cui la routine effettua le dovute 
variazioni 

interleave questa variabile globale fissa il numero di blocchi di 
separazione fra un biocco e il successivo quando la routine 
alloca i settori del disco. Impostando opportunamente il 
numero di settori da saltare si può raggiungere una grande 
efficienza. Per le routine di scrittura del turbo del 1541 il numero 
più adatto è otto. Con un interieave di otto settori si ottiene la 
massima velocità di salvataggio dei dati e questa scelta è tanto 
più conveniente quanto più sono vasti i grupf» di dati con cui 
si lavora! Non risulta invece molto efficiente per le routine di 
lettura del turbo. Per i file che devono ^ere letti frequente¬ 
mente, l'inteilèave che rende massima l’efficienza è 9. Questo 
naturaimente danneggia l'effìci^za nelle procedure di scrittu¬ 
ra, e si deve quindi fare una scelta diversa caso p«’ caso. 
GEOS iiìTposta la variabHe globale interleave con il valore di 
default 8 
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Restitidace: r3 indirizzo T/S del blocco libero allocato 

X codice d’errore da disco 

0 l’operazione ha avuto successo 

INSUFF-SPACE questo errore indica che sul disco 

non sono presentì abbastanza bloc¬ 
chi IlDerl. Se si verifica un errore da 
dsco, di qualsiasi tipo, la routine 
interrompe la propria esecuzione, 
registrando le rrxxjtìiche fatte fino ad 
allora nefla copia della BAM memo¬ 
rizzato in curDirHead. Dai morr^to 
che la routine agisce sulla copia 
della BAM in merrxxia e non trasferi¬ 
sce il Directory Header Block nuova¬ 
mente su disco, le applicazioni pos¬ 
sono anche utilizzarla per sapere in 
anticipo se vi sono abbastanza 
blocchi liberi su disco 

curDirlHead la BAM contenuta nella copia del Directory Header Block, 
memorizzata nel buffer curDirHead, viene restituita con 
l’aggiomamento sui nuovi settori allocati. Sino a questo 
momento il disco non ha subito alcuna variazione, dal 
momento che la routine non riscrive su disco la nuova BAM. 
É compito delt’applicazione, dopo l’esecuzione di BIkAlloc, 
riscrivere su disco l’intero CMrectory hieader Block tramite la 
routine PutDirHead 

Distnigge: a. y, r6, r7, rSH 

Sinossi: SetNextFree cerca un settore lasero cte attocare iniziando la ricerca dai settore 

indicato. Durante la ricerca tei routine |:xova a mantenere Hnterleave indicato 
dal codice di chiamata. Una volta che ha identificato un blocco libero, lo 
contrassegna come allocctìo nella copia della BAM mantenuta nel buffer 
curDirHead, e restituisce il suo indirizzo T/S. SetNextFree viene utilizzata da 
BlkAUoc, oppure da NxtBtkAlloc, per avocare una s^ di blocchi separati da 
un interleave ideale. Una scelta accurata dell’lnterleave è necessaria per 
rendere ottimale la velocità di accesso al file, o record. 





Funzione: Restituisce lo st^o (aikscato o cfisaHocato) del settore incycato dali’lnclirizzo 

T/S specificato. 

Indirizzo: $C2AO 


Parametri: r6 indirizzo T/S del s^ore di cui si vuole conosc^e lo stato 

Preparazione 

cM drive: Attevereo SetDevice devono es^e impostati curOrive e curOevice, e la 

BAM del disco coaente dev'essere trasferita in menrtoria attraverso 
OpenDisk o NewDisk. 

Reatitidace: A eccezione del flag Z del PSW, queste variabiii riguardano solo il dsk drive 
1541 

a il byte che contiene y bit corrispondente al sclere indic£do. Tutti gli altri 

bit sono azzerati 

Z riporta lo stato del bkxxo e questa informazione vale per tutti i tipi di 
drive: 

1 il settore è disallocato 
0 y settore è allocato 

r7H offset all’Interno del buffer curDirEntry che indica il byte contenente y 
numero di blocchi Iberi presenti nella traccia indicata 
X offset all’intemo dei buff^ curOirEntry che indica il byte contenente il 
bit che corrisponde ai settore indcato 
rSH questo byte è la maschera per isolare y bit corrtepondente ei settore 
indicato, aU'intmio del byte deHa BAM puntato da x 

Distrugge: a. x, r7H, r8H 

Sinossi: FindBAMBit, ricevendo l’indgtzzo T/S di un settore cM disco, ne restituisce 

k) stato decodificando le kiformazioni contenute neya BAM. Se il settore è 
disallocato, N flag Z del PSW viene impostato a 1. 

Successive versioni del Kernel saranno probabilmente in grado di gestire 
più di una BAM alla volta, come dovrebbe accadere per esempio nel caso 
di drive in gr£x1o di bggere dischi a doppki faccia. Le informazkxii restituite 
da questa routine, se si eccettua y flag Z, sono significative solo se il disk 
drive è il 1541, e devono essere ignorate se vengono usati drive differenti. 
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FreeBlock 


Funzione: 

OsaHoca un singolo settore dei (Sco contrassegnandolo opportunam^te 
nella cx>pla della BAM contenuta nel buffer curC^ead. 

Imfirizzo: 

$C2B9 

$9844 

per GEOS VI .3 e superiori 
per GEOS V1.2 

Chiama: 

FindBAMBit 


Parametri: 

CurDirHead 

r6 

contiene la copia d^ E^ectory Header Blodt del disco 
indirizzo T/S del settore da disallocare 


Preparazione 

del drive: Attraverso SetDevice devono essere impostati curOrive e curDevice. e la 

BAM del disco corrente dev'essere stata trasferita in memoria attraverso 
ÒpenD'sk o NewDisk. 


Reatituisce: curDirHead la copia della BAM mcuiténuta in questo buffer è aggiornata per 

indicare che il settore è stato disaflocato 
X codice d'errore da disco 


Diatnigge: a, r7H, r8H 


Sinossi: A>^ndo a esposizione H drive inizializzato e l'indirizzo T/S del settore, la 

routine disailoca il blocco e, n^ copia della BAM, imposta a 1 il bit di 
contrassegno che caratterizza lo steto del blocco (allocato, disallocato). 
Questa routine è riportata netta tavola delle jump-cail soltanto a partire dalla 
versione 1.3 di GEOS. L’appiteazione deve controllare quale versione dd 
Kernel di GEOS ha a disposizione, perché nel caso della versione 1.2 questa 
routine può essere eseguita solo chiamando il suo indirizzo direttamente 
att'intemo del Kernel {$^A4) b non ricorrendo alla jump table. 






Funzkxié: SetGDirtntry costruisce il File Entry di un file nel buffer diiEntryBuf e lo 

memorizza nel prwrx) spazio Hbero che incontra nella pagina della directory 
indicata in rIOL. Attenzione: questa routine dev’essere utilizzata con dischi 
in formato GEOS (vedere CkDkQEOS e SetGEOSDi^). SetGDirEntry vierre 
spesso eseguita da Sav^He. 

hìdtrizzo: $C1F0 

Chiamata da: SaveFile 

Chiama: BIdGDirEntry, GetFreeDirBik 

Parametri: r6 punta al buffer fileTrScTab che contiene la tavola degli indirizzi 

T/S dei blocchi allocati 

i9 punta ai buffer fiieHeaderBIock che contiene una copia del 

blocco File Header del file. I primi due byte del blocco FHe 
Head®’, all’atto della memrÀizzazione su disco, contengono 
rispettivamente i valori $00 e $FF. Però, finché il blocco resta 
in memoria quésti due byte devono contenere l’indirizzo della 
stringa a terminazione nulla che riporta il nome del file. Dal 
momento che i valori per i primi di» byte di un blocco File 
Headw non variano mai, è la routine che all'atto della 
memorizzazione sostituisce 3 iXKitatore alla stringa dei none 
con i valori $00 e $FF. Vedere 3 capitolo 13 per maggiori 
dettagli sulla struttura del File Header di un file 
rIOL numero della pagina della directory all’Interno della quale la 

routine tenta la mertìorizzazlone del File Entry 
curDirH«id contiene la credei Directory Header Blod< del disco corrente 
flIeTrScTab contiene 9 percorso dei btoccW appositSBìiente allocati per 
contenere 9 file, o il record 

/ 

Rettitulace: r6 contiene un puntatore che individua lungo il buffer fHeTrScTab 

l’indirizzo T/S del primo blocco allocato per ricevere i dati del 
file. Si tratta di un parametro creato dafla routine per essere poi 
passato a WriteFBe. Di S(^, la prima word del buffer 
fìleTrScTÉdJ Indvickja l’ìrKtiriZzO In memoria del blocco File 
Head^, e la seconda indivichja l’kricfirizzo T/S del primo blocco 
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del file (o dei bloccx) indice nei fNe a struttura VUR) 
dirEntryBuf contiene il FHe Entry creato prelevando i dati dal blocco F8e 
Header. CXiestì dati includono l’ora e la data detl’ultimo 
intervento sul file, e i puntatori al blocco File Header e al prvno 
blocco dati dei file (se il file è a struttiN’a VUR questo prvno 
blocco contiene la tavola vKfice del file) 
diskBy<Buf questo buffer contiene il blocco della cfirectory aU’intemo dei 
quale la routine ha memorizzato il nuovo Rie Entry, li blocco 
modificato è stato memorizzato su disco 
curlDirHead dal momento che la routkie può trovarsi nella condizione di 
dover aggiungere un blocco aSa. directory, la BAM può subire 
delle modifiche. Questo buffer contiene la copia della BAM 
modificata 

Nota: il contenuto dei buffer curOirHead dev’essere riscritto 
su disco nei caso che la routine abbia dovuto allocare 
un nuovo blocco p^ la directory chiamando la routine 
GetFreeDirBIk. SetGOirEntry non effettua queste ope¬ 
razione 

Distrugge: a, y, rO - r5, r7, r8 

Stoiossi: SetGOffEntry crea il Rie Entry per un file e k) memorizza su disco. 

Normatmerrte SetGDirEntry è chionate daHa routine SaveFSe neH’ambito del 
processo di salvataggio di un file su disco. Dovrebbe essere già state 
eseguita BikAiloc, per allocare su disco to spazio necessario al file e per 
aeare nel buffer fileTrScTab la tavola degli indirizzi T/S dei blocchi allocati. 

Dopo aver ricevuto attraverso r10L nivnero della pagina della directory 
neiia qucye si desidera memorizzale il File Entry del fHe, SetGDirEntry cNama 
GetFreeDirBIk per allocare un File Entry in quella pagina (ogni pagina 
raffigurate in deskTop contiene al massimo otto icone di file, e un blocco 
defia directory contiene al massimo otto F3e Entry. Non è una coincidenza: 
pagine e bloccN, in questo contesto, sono interscarràMabili). Se la pagina 
indicataè già piena, GetFreeDkBik estende la ricerca alle pagine successive, 
e se necessario alloca un nuovo blocco da aggiur^ere alla cKrectory. Se tutte 
le pagro della drectory sono piene, GetFreeDirBIk restituisce un errore che 
viene a slb volte restìteito da SetGDkBttc. 

GetFreeDitBlk copia nel buffer diskBIkBuf il blocco delia directory nel quale 
ha trovato lo spa:ù> per m FHe Entry, SetGDìrBIk preleva dai blocco FHe 
Header (quello dei file residente in memoria e puntato da r9) tutte le 
informazteni che occorrono per la creazione dei FHe Entry, ad eccezione 
dell’ora e della date correnti. Sulla base di queste informazioni, SetGDH€ntry 
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chiama BkJGDn&itry per costruire il FHe Entry nel buffer dirEntrySuf. 

BIdGDHEntry aloca tt prvno dei settori elencati netta tatroia degli indirizzi 
(fleTr^Tab) pe»* mernorèo^ H jS^occo file Header. Se il fite è a struttura 
VUR, tt secon(k> bk>cco M corx^enarnento viene attocato per contenere 
la tavola incttce del file, il registro r6 misrimente puntava alla prima locazione 
nel buffer fiieTrScTab, mentre ora deve pxintare alla word dei buffer che 
contiene l'indirizzo T/S del primo blocco cKsponibtte su disco per ricevere i 
dati. Quindi r6 viene incrementato di 2 n^ caso di un normale file a struttura 
SEQUENTIAL, mentre l'ttìcremento sale a 4 nel caso di un file a staittura 
VUR. Riassumendo: r6 individua la word che contiene l’indirizzo T/S del 
primo blocco disponibile. GetGOirEntry memorizza i valori $00 e $FF 
rispettivamente nei byte 0 e 1 del blocco File Header all’atto della 
memorizzazione su disco (questi due byte non sono significativi per un 
blocco File Header). 

SetGDirEntry copia nel buffer dìskBIkBuf il File Entry appena reafizzato, e 
scrive la data corrente e l’ora nel blocco File Fleader ancora in memoria. Infine 
riscrive su disco il blocco delia cttrectory contenente il nuovo File Entry. 

Nota: SetGOREntry non scrìve su disco i blocchi File Header, Directory 
Header, e (se VUR) tavola indice. Si limita ad aggiornare, su disco, H blocco 
della directory che contiene il File Entry. 

Il Directory Header Block consenrato in nwnoria potrebbe aver subito 
delle variazioni in seguito all’aggiunta d m blocco alla direCfory« e quind 
dovrebbe essere riscritto su disco appena dopo l’esecuzione della routine 
SetGDirEntry. 
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BldGDIrEft^ 


Funzione: Di solito questa routine è chiamata da SetGDirEn^, che a sua volta è 

chiamata da SaveFile. BIdGESrEntry crea in memoria il File Entry di un file 
prelevando le informazioni dal blocco File Header che dovrebbe anch’esso 
trovarsi in memoria. 


Indirizzo: $C1F3 

Parametri: r€ puntatore alia tavola degli indirizzi T/S memorizzata nel buffer 

fHeTrScTab 

r9 puntatore al blocco File Header menwrìzzato nel buffer 

fileHeader. I primi due byte di questo tìoox) dovrebbero 
contenere i VÉrfori $00 e ^F. Quando l’applicazione chiama 
questa routine, i i^imi due byte devono contaore un 
puntatore alla strìnga del nome del file in memoria. Consultare 
il capitolo 13 per mé^iorì dettagli sulla struttura del blocco File 
Header 

fileTrScTab contiene la lista degli indirizzi T/S dei settori allocati per 
contenere il file 


Restitiiisce: r6 contiene un puntatore che individua lungo il buffer fileTrScTab 

rindirizzo T/S del primo blocco allocato per ricevere i dati del 
file. Si tratta di un parametro creato dalla routine per essere poi 
passato a WriteFile. Di solito, la prima word del buffer 
fileTrScTab individua l’indirizzo in memoria del blocco Rie 
Header, e la seconda individua l’indirizzo T/S dei primo blocco 
del file (o del blocco indice nei file a struttura VÙR) 
dirEntryBuf contiene il File Entry aeato prtìevando i dati dal blocco File 
Header. Questi dati includono l’ora e la data dell’ultimo 
intervento sul file, e i puntatori al blocco File Header e al primo 
blocco dati del file (se il fHe è a struttura VUR questo primo 
blocco contiene la tavola indice del file) 


a, y, rO - r5, r7, r8 


BIcODirEntry costruisce in memoria il File Entry di un file. Il File Entry viene 
memorizzato nei 30 byte del buffer dirEntryBuf. Le informazbni necessarie 
alla sua aeazione sono prelevate dal blocco FHe Header, anch’esso 


Distrugga: 

Sinossi: 
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conservato in memoria. Questa routine si utilizza nella procedura di 
salvataggio di un file su disco. Dovrebbe essere sempre eseguita dopo um 
chiamata a BikAlloc. che alloca lo spazio su disco e crea la tavola 
fileTrScTab, e a GetFreeC^tìlk, che alloca un File Entry libero su disco. 

In fileTrScTab la prima word fornisce l'indirizzo al quale BIdGDirEntry alloca 
il blocco File Header del Nel caso di una struttura VUR, il blocco 
indirizzato dalia seconda word in fileTrScTab viene allocato per contenere la 
tavola indice. H registro r€ che inizialmente puntava alia prima locazione nel 
buffer fileTrScTab, ora deve puntare alla word del buffer che contiene 
l'indirizzo T/S dei primo blocco disponibile su disco per ricevere i dati. Quindi 
r6 viene incrementato di 2 nel caso di un normale file a bruttura 
SEQUENTIAL, mentre l'incremento sale a 4 nel caso di un file a struttura 
VUR. Riassumendo: r6 individua la word che contiene l'indirizzo T/S del 
primo blocco disponibte. GetGDirEntry menriorizza i valori $00 e SFF 
rispettivamente nei byte 0 e 1 dei blocco File Header gyi'atto della 
memorizzazione su disco (questi due byte non sono significativi per un 
blocco File Header). BldGDiiEntry restituisce nel buffer diiEntryBuf U File 
Entry completo del file. 





Funzione: Dopo aver ricevuto l'indirizzo T/S di un blocco appartenente a una 

concatenaziorìe memorizzata su disco, restituisce in memoria una tavola che 
riporta tutti gli indirizzi T/S dei blocchi successivi. 

Indirizzo: $0205 

Parametri: r1 indirizzo T/S dei blocco della concatenazione dai quale iniziare 

l’operazione 

r3 puntatore al buffer nel quale la routine deve memorizzare la 

Usta degli irìdmzzi T/S che genera. DT norma r3 punta a 
fileTrScTab 

Restituisce: r1 indirizzo T/S dell’ultimo blocco incontrato lungo la concatena¬ 

zione 

r2 inalterato 

diskBikBuf contiene una copia dell’ultimo blocco del file 
Distrugge: a, y, r1,r4 

Sinossi: Questa routine riceve un puntatore T/S che indica il blocco di una 

concatenazione, e aea una tavola in memoria che riporta tutti gli indirizzi T/S 
dei blocchi che seguono, lungo la concatenazione, queHo indicato come 
parametro. Ogni indirizzo T/S è memorizzato in una word, e la tavola puntata 
da r3 elenca tutte le word significative. Di sdito la tavda è memorizzata nei 
buffer flIeTrScTab. 






Funzione: Cmicelta un ^ con un solo accesso quando è già disporùbite una Usta 

compieta deg^i indàlzzi T/S dei blocchi di cui it file è composto. 

Indirizzo: $C244 


Chtama: GetDirHead, FreeBlock, PutDirHead 

Parametri: rO puntatore aHa strìnga a terminazione nuiia che contiene il nome 

del file da cvx^Hare 

r3 puntatore ala l^degiindlrizzfT/S dei blòcchi da disattocare, 

in genere fileTrScTab 

curOrive li num^ d dispodfivo del drive corrente 
fileTrScTab contiene nonmalmente la listò degli indirizzi T/S dei blocchi da 
disaiocetfe che costituiscono il file 

Preparazione 

del drive: Per accedere ai disco con successo, il drive dev'essereiniziaiizzato. Il byte 

d’identificazione D del disco dev'essere memorìz 2 »to nela RAM di sistema 
dei drive. La variabile curDrìve deve contenere il numero di dispositivo dei 
drive corrente, e viene aggiornata tiamite una dìiamatò alla routine 
SetOevice. Anche NewDì^ o OpenOisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le varìabyi necessarie sono 
già state impostate o aggiornate da routine di atto livello. Dal momento che 
scendendo di livello le routine diventarìo motto più rapide n^’esecuzione, in 
questo modo H programmatore può ottimizzare notevolmente gli accessi al 
disco. 

Restttidsce: x codice d’errore da disco 

curDirHead la BAM aggiornata contenuta nel Directory Header Block in 
memoria. La routine riscrìve l’intero blocco ^ disco 
turbo il codice turbo è ctisattivato, ma non è cancellato dalla memoria 

interna dei drive 

dirEntryBuf il File Entry del file cancellato viene caiservato in memoria a 
causa della chiamata alla routine FindFtie 
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Distrugge: 

Sinossi: 


Blocco Directory II blocco della directory contente il File Entry del file 
cancellato viene riscritto su disco con y File Entry 
azzerato 

Blocco File Header cancellato dai disco insieme al resto del file 
Blocco Tavola Indice cancellato dal disco insieme al resto dei file 


a, y, rO - r9 


La routine DeleteFile (Hiustrata nel capitolo precedente) richiede come unico 
parametro il nome dei file daccuicellare, ma deve effettuare molti accessi al 
disco ed è quindi abbastanza ienta. In genere, quando si manipola un file si 
ò ri po^sso di molte riformazioni, oltre ai nome del file. Se l’appicseione, 
fra le varie informazioni che possiede sul file, conserva anche la tavola 
fileTrScTab, (XJÒ utilizzare per la canceiiazione FastOeFile. Questa routine 
richiede come parametri il nome del fye (per cercare e cancellare il File Entry 
da disco), e la lista dei blocchi cb disallocare. Oltre a queste informazioni, 
occorrono ancora un accesso aita BAM per disallocare i blocchi del file e un 
accesso alla directory per canc^are ilFile Entry. Le applicazioni, se sono in 
possesso di questi dati, possono canceilare i file con un notevole risparmio 
di tempo, dal momento che FastOelFiie è rapidissima. La lista dei blocchi 
memorizzata nel buffer puntato da r3 può essere gena’ata dalla routine 
FollowGhain. 





Funzione: Dopo aver ricevuto il File Entry cfi un file, la routine Pisailoca tutti i settori 

occupati dal fBe su cBsco, ma lascia inalterato H File Entry nella directory. 

Indirizzo: $C226 


Chiamata da: OeleteFile 

CMama: GetOirHead, PutOirHead 

Parametri: dirEntryBuf File Entry del file 

r9 puntatore al buffer dirEntryBuf 

Preparazione 

dei drive: Per accedere ai disco con successo, il drive dev’essere inizializzato. Il byte 

d’identificazione ID dei disco dev’essere memorizzato n^la RAM di sistema 
del drive. La variabile curDrive deve contenere il numero di dispositivo del 
drive corrente, e viene s^iornata tramite una chiamata alla routine 
SetDevice. Anche NewDisk o OpenDisk devono essere già state chiamate 
per impostare altre variabili. In alcuni casi il programmatore può decidere di 
utilizzare routine di livello inferiore, se osserva che le variabW necessarie sono 
già state impostate o aggiornate da routine di aito UveRo. Dai momento che 
scendendo di livelb le routine diventano molto più rapide r^ll’esecuzione, in 
questo modo il programmatore può ottimizzare notevdmente gli accessi al 
disco. 

Restituisce: x codice d’errore da disco 

curDirHead contiene la BAM aggiornata. È la copia del Directory Header 
Block riscritto su disco 
disco la BAM viene aggiornata 

disco il blocco delia directory che contiene il File Entry dei file 
cancellato non viene acereto 

disco H blocco File Header del file viene cancellato con il resto del file 

disco il blocco indice, se il file è a struttura VUR, viene cancellato 
insieme al resto del file 
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Uttnigge: a, y, rO - r9 

Sinossi: FreeFde riceve il File Entry di un file e quindi agisce sulla BAM del disco 

disallocando tutti i settori d^ file, ma lasciando inalterato il File Entry nella 
directory. La routine furrziona per ogni tipo di file, compresi quelU a strutti^ 
VUR. In quest’ultimo caso la routine caiiceila anche la tavola indice e tutti i 
record del file. Se si desidera una cancellazione completa, che comprenda 
anche il FNe Entry, si deve utilizzare la routine DeteteFHe. FreeFile è una 
subroutine di OeleteFile. 
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ChangeDiskDevice 


Funzione: Ordina al (live di cambiare U suo numero d’acx:esso sui bus seriede. 


Indirizzo: $C2BC 

Parametri: a nuovo numero di dispositivo; 8, 9,10 o 11 

Restituisce: x stato dell’errore da disco, x » 0 corrisponde a nessun errore. 

Consultare l’appendice per una lista compieta degfi errori da 
disco 

Distrugge: a, x, ri 


Sinossi: ChangeDiskDevice viene chiamata da deskTop, per esempio quando si 

richiede di aggiungere un drive. Ouesta routine comunica ai drive un nuovo 
numero di accesso ai bus seriale. 






Funzione: Inizializza il sistema e cede il controllo airapplicazione correntemente In 

memoria. 


Indirizzo: $C22F 

Panunetri: r7 indirizzo della routine d’iniziaiizzazione dell’applicazione alia quale si 

desidera cedere il controllo 

Restituisce: Niente 

Distrug^: In genere tutti i registri 

Sinossi: Questa routóie procede a intzializzare il sistema tramite l'operazione di 

“partenza a cakto* (Warm Start) descritta nel capitoto 20 e cede il controllo 
all’indirizzo contenuto In r7. Questo indirizzo deve individuare la routine 
d’iniziaiizzazione dell’applicazione. 





4 X ROUTINE DI 
1 W PRIMITIVO 


LIVELLO 


Nel capitolo 15 abbiamo esaminato le routine di livello intermedio che GEOS mette 
a disposizione delle applicazioni. Consideriamo ora alcune routine di livello prlrrùtivo 
che formano la base di lavoro su cui è stato sviluppato il sistema dei file di GEOS. 
Eccone l'elenco: 

InitForlO 

DoneWithIO 

PurgeTurbo 

EnterTurbo 

ExitTurbo 

ReadBlock 

WriteBlock 

VerWriteBlock 




Funzione: Questa routine dev’essere chiamata prima di ogni accesso al bus seriale. Ha 

il compito di disabilitare gli interrupt e gli sprìte, di attivare la ROM del Kernel 
ctói C-64 e lo spazio di I/O, e infine di aggiornare alcune variabili per le 
comunicazioni seriali. 

Indirizzo: $C25C 

Parametri: Nessuno 

Restituisce: Gli interrupt e gli sprite disabilitati. La routine salva temporaneamente il loro 
stato, forza l’esecuzione di un NMI (ma fa in modo che dopo resti inattivo), 
disattiva l’IRQ, attiva la ROM del Kernel del C-64 e lo spazio di I/O 

Distrugge: a 

Sinossi: Si deve chiamare questa routine prima di compiere qualsiasi operazione di 

accesso al bus seriale. Ogni funzione ordinariamente gestita dal sistema, 
come gli interrupt e gii sprite, viene sospesa. Viene salvata la configurazione 
corrente dei banchi di memoria, e vengor» attivati il Kernel del C-64^ lo 
spazio di I/O. InitForiO aggiorna inoltre i vettori IRQ e NMI, puntandoli a routine 
fittizie che non svolgono nessuna operazione; configura la porta seriale nel 
suo stato consueto; imposta un contatore che si deaementa generando un 
NMI in modo che la linea NMI sia mantenuta a livello basso sino a quando 
non viene eseguita la routine DoneWithIO; disattiva le chiamate di interrupt 
generate dal raster; selva il registro che contiene i flag di stato degli sprite 
e infine disabilita gli sprite. 






Funzione: Questa routine dev’essere chiamata quando si conclude l’accesso al bus 

seriale. Riabilita gli sprite, gli inlerrupt, ripristina la configurazione di memoria 
precedente alla chiamata di InitForlO e ripristina il normale funzionamento 
della macchina in ambiente GEOS. 

Indirizzo: $C25F 

Parametri: Nessuno 

Reatttidace: H sistema nella configurazione precedente alla chiamata di InitForlO 

Diairuggo: a 


Sinossi: DoneWithIO ripristna la configurazione di sistema precedente alia chiamata 

di InitForlO, riabilita gli aprite e gli interrupt di NMI, di IRQ e di raster e riattiva 
la configurazione dei banchi cti memoria precedentemente salvata. 





Funzkme: Restituisce il conti'olb dei processore del disk drive 1541 alle routine del DOS 

residenti nella ROM interna al drive. Imposta un flag per indicare ai sistema 
che il codice del turtx) non è più residente nel disk drive. 

Indirizzo: $0235 

Chiamata da: QetBiock, PutBlock, NewDisk, ReadFile 
Chiama: InitForlO, DoneWithKD 

Paramatri: curDrive numero del drive per cui dev’essere disattivato il turbo 

turboRags questa variabile globale contiene i flag che indicano io stato 
del codice turbo nel drive 8. Per il drive 9 è turboRags + 1. 
La roteine vi accede p& aggiornare i flag 
Bit? 

1 indica che il codice turbo è ancora residente nella 
RAM del drive 

0 indica che il codice turbo non è residente nella RAM 
del drive 

Bit 6 

1 indica che il codice turbo nella RAM del drive è in 
esecuzione 

0 indica che il codice turbo nella RAM del drive non è 
in esecuzione 

Restituisce: x codice d'errore da disco 

turboFlags questa variabile globale contiene i flag che indicano lo stato 
del codice turbo nel drive 8. Per il drive 9 è turboFlags + 1. 
Bit? 

0 per indicare che il codice turbo non è più residente 
nel drive 

Bit 6 

0 per indicare che il codice turbo residente nel drive 
non è in esecuzione 


Distrugge: a, x, y, rO - r3 
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Sinossi: Si chiama PLirgeTurbo per far cessare l'esecuzbne del codice turtx) nei drive 

e indbare (tramite i flag d^ variabib turboFlags associata si drive 
selezionato) che questo non è più in esecuzione e non è più residente. In 
genere le a^icazione utilizzano F^rgeTurbo quando devono inviare al drive 
un comando DOS '1541 che pobebbe altware il contenuto della RAM del 
drive. Quando il astema deve comunbare con il drive, accede a turboFlags 
per sapere qual è b stato del codice turbo e si comporta di conseguenza. 

Per riallocare e riattivare il cocSce turbo nel drive occorre chiamare la 
routine EnterTurbo. 





Funzione: Se il codice turbo non è allocato neHa memoria del drive selezionato, la 

routine lo riscrive e quindi lo attiva. Altrimenti si Fimita ad attivarlo. 


Indirizzo: $C214 

Chiamata da: QetBlocks, NewDisk 

Chiama: SetDevice, InitForlO, DoneWithIO 

Parametri: curDrive il numero del drive interessato alla riattivazione del codice turbo 

tuiboFlags questa variabile globale contiene i flag che indicano lo stato del 

codice turbo nel drive 8. Per il drive 9 è turboFlags + 1 

Bit? 

1 indica che il codice turbo è ancora residente nella RAM 
del drive 

0 indica che il codice turbo non è residente nella RAM del 
drive 

Bit 6 

1 indica che il codice turbo nella RAM del drive è in 
esecuztone 

0 indica che il codice turbo nella RAM dei drive non è in 
esecuzione 

Restituiace: x codice d’errore da disco 

drive il codice turbo è in esecuzione 

Distrugge: a, y 

Sinossi: EnterTurbo ordina ai sistema operativo del drive 1541 d'iniziare l’esecuzione 

del codice turbo. Se i flag della variabile turboFlags indicano che il codice 
non è residente, la routine lo trasferisce nuovamente nella memoria del drive 
e quindi lo manda in esecuzione. EnterTurbo viene eseguita ogni volta che 
si desidera compiere un’operazione con il disco, il codice turbo, conclusa 
l’esecuzione deUa routine, mantiene il possesso del bus seriale. Se si 
manifesta la necessità di utilizzare il bus seriale per comunicare con un altro 
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dispositivo, si deve ricorrere alia routine ExitTurtx). La gestione di queste due 
routine è affidata di solito aHe routine di accesso ai disco d’afte liveiio. 
Tuttavia, le applicazioni die desiderano accedere ai drive al liveiio piCi basso 
possono utilizzare queste due routine drettamente. In mancanza di precise 
esigenze, consigliamo di non lasciare il codice turbo attivo nei drive. È 
preferibile che l’applicazione io disattivi, chiamando la routine ExitTurbo, al 
termine di ogni accesso. 




Ftmzion»: disattiva il codice turbo net drive corrente. La routine non lo disalloca: il 

codice turbo è ancora prosate nel drive e può essere riattivato tramite la 
routine EnterTurbo. 


Indirizzo: $C232 

Parametri: curDrive il numero del drive interessato alla disattivazione del codice 

turbo 

Restituisce: Il bit 6 del turboFlag associato al drive impostato a 0 
Distru^^: a, x, y, rO - r3 

Sinossi: ExitTurbe disattiva il codice turbo residente nel drive indicato da curOrive, ma 

non lo disaiioca. Il turbo può essere riattivato semplicemente chiamando 
ErrterTurbo. 






Funzione: Svolge la stessa funzione di GetBlock, ma presuppone che il codice turbo 

nei drive sia già in esecuzione e gli sprite e gli interrupt siano già 
disabilitati. 


Indirizzo: $C21A 

Chiamate da: GetBlock 

Parametri: r1 indirizzo T/S del settore sul disco 

r4 indirizzo in memoria del buffer nel quale memorizzare il blocco 

curDrive il numwo del drive corrente 

Sistema: il drive dev’essere stato inizializzato tramite OpenDisk o NewDisk, e 

dev’essere stato selezionato sul bus seriale tramite la routine SetDevice. Lo 
spazio di I/O del C-64 dev’essere attivo, mentre gli sprfte e gli interrupt 
devono essere stati precedentemente disabilitati. 

Restituisce: x codice d’errore da disco 

r4 puntatore al blocco trasferito in memoria (inalterato) 

r1 inalterato 

Distrugge: a, y 

Sinossi: ReadBlock è la più primitiva routine di accesso al disco di cui GEOS dispone. 

Quando si leggono o si scrìvono lunghe concatenazioni di blocchi su disco, 
è opportuno minimizzare il tempo di lavoro delta testina del drive. Le routine 
d’alto livello messe a dispoazione da GEOS per accedere a lunghe 
concatenazioni di blocchi, sono relativamente rapide. Ma per H salvataggio 
dei file si può raggiungere una velocità anche maggiore creando una routine 
di scrittura che salvi tutto il file ed effettui la veri^ in un secondo tonpo. 
Le applicazioni dotate di routine per la gestione dei file che non seguono il 
normale sistema della concatenazione dei blocchi, possono adottare 
tecniche diverse per aumentare la velocità di accesso. 
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ReadBiock dev'essere utilizzata in questo modo; 


jsr EnterTurbo 
jsr InitForlO 
Jsr ReadBiock 

Jsr ReadBiock 
Jsr DoneUithlO 


; Randa in esecuzione il codice turbo nel drive 
;prepara il sisteta per l'accesso al drive 
; legge il blocco da disco 
1 legge altri blocchi 

; riporta il sistema al suo stato normale 


L’applicazione deve passare alla routine l'indirizzo T/S dei blocco da 
trasferire in memoria. ReadBiock trasferisce il blocco dal disco nei drive al 
buffer indicato in r4, e legge anche la prima word che contiene l’indirizzo T/S 
del blocco successivo. 

Prendiamo in considerazbne un caso reale: supponiamo che l’applicazio¬ 
ne memorizzi alcune informazioni chiave nei primi byte contenuti nel primo 
blocco di ogni record di cui è composto un file a struttura VUR. Quando 
possiede in memoria la tavola indice dei record, l’applicazione |xiò 
agevolmente accedere firamite ReadBiock ai primo blocco di ogni record e 
prelevare le informazioni chiave. 





Funzione: Svolge la stessa funzione di PutBlock, ma presuppone che il codice turbo 

nel drive sia già in esecuzione e che gli sprite e gli interrupt siano già stati 
disabilitati. 


Indirizzo: $C220 

Chiamata da: PutBlock 

Parametri: r1 indirizzo T/S del settore nel quale memorizzare il blocco 

r4 puntatore a) buffer da 256 byte che contiene il blocco da 

trasferire su disco, in genere diskBIkBuf 

Sistema: Il drive dev’essere stato inizializzato tramite OpenDisk o NewDisk, e 

dev’essere stato selezionato sul bus seriale tramite la routine SetDevice. Lo 
spazio di I/O del C-64 dev’essere attivo, mentre gli sprite e gli interrupt 
devono essere stati precedentemente disabilitati. 

Restituisce: x codice d’errore da disco 

r4 puntatore al buffer (inalterato) 

r1 inalterato 

Distrugge: a, y 

Sinossi: WriteBlock è la routine di scrittura su disco più primitiva di cui GEOS dispone. 

Richiede che gli interrupt e gli sprite siano disabilitati, e che il codice turbo 
sia in esecuzione. Perché un file sia memorizzato correttamente, i blocchi 
devono essere disposti a catena (cioè ogni blocco deve contenere nei primi 
due byte l’indirizzo T/S del blocco successivo). Quindi la disposizione a 
catena deve esistere già quando i blocchi si trovano nella memoria del C-64. 
Di solito il blocco da trasferire viene memorizzato nel buffer diskBIkBuf. 
WriteBlock dev’essere utilizzata in questo modo: 

jsr EnterTurbo jmanda in esecuzione il codice turbo nel drive 

jsr InitForlO ;prepara il sistema per l'accesso al drive 

jsr WriteBlock jscrive il blocco su disco 
,.. jscrive altri blocchi 

Jsr WriteBlock 

Jsr OoneWithIO jriporta il sistema al suo stato normale 
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L’applicazione deve passare alla routine l’indirizzo T/S del settore su disco 
dove trasferire il blocco residente in memoria (che deve contenere nei primi 
due byte l’indirizzo T/S del blocco successivo). Di solito l’applicazione può 
servirsi altrettanto bene di una routine d’alto livello, e non ha bisogno di 
ricorrere direttamente a WriteBlock. 

Nel caso si desideri effettuare la verifica del blocco appena trasferito, è 
sufficiente, subito dopo la chiamata alla routine WriteBlock, eseguire 
VerWriteBlock. Dal momento che le due routine utilizzano gli stessi parametri 
e WriteBlock non li altera, possono essere chiamate consecutivamente. 
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Funzione: Questa routine viene eseguita subito dopo la chianrata a WriteBlock per 

verificare i dati trasmessi su disco. 


Indirizzo: $0223 

Parametri: r1 indirizzo T/S del settore da verificare con i dati in memoria 

r4 puntatore al buffer da 256 byte che contiene il blocco da confrontare con 
quello contenuto nel settore del disco (di solito diskBIkBuf) 

Sistema: Il drive dev’essere stato inizializzato tramite OpenDisk o NewDisk, e 

dev’essere stato selezionato sul bus seriale tramite la routine SetDevice. Lo 
spazio di I/O del C-64 dev’essere attivo, mentre gli aprite e gli interrupt 
devono essere stati precedentemente disabilitati. 

Restituisce: x codice d’errore da disco; se la verifica non ha avuto successo, la 
routine restituisce l’errore WR_VER_ERR (codice $25) 
r4 puntatore al buffer (inalterato) 
r1 inalterato 

Distrugge: a, y 

Sinossi: VerWriteBlock è una routine primitiva che viene di solito eseguita in 

combinazione con WriteBlock per verificare che il blocco sia stato 
memorizzato su disco correttamente. Dal momento che WriteBlock non 
altera i parametri che ha ricevuto, subito dopo la sua esecuzione può essere 
fatta la chiamata jsr VerWriteBlock senza alcuna operazione intermedia. 
Vediamo un tipico impiego della routine. 

jsr EnierTurbo jmanda in esecuzione il codice turbo nel drive 

jsr InitForlO ;prepara il sistema per l'accesso al drive 

jsr WriteBlock jscrive il blocco su disco 
jsr VerWriteBlock ;verifica la correttezza del trasferimento 
jsr DoneWithIO ; riporta il sistema al suo stato normale 
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I FILE CON 
STRUTTURA VLIR 


La struttura dei file VLIR è stata ideata e realizzata per permettere alle applicazioni 
di crescere e superare i 30K di memoria disponibili in ambiente GEÒS. Greizie 
all'elevata velocità di accesso al disco che si ottiene con GEOS, diventa particolarmen¬ 
te utile suddividere un’applicazione in più moduli e all’occorrenza richiamarli da disco. 
Il miglior modo per gestire un'applicazione suddivisa in moduli è mantenere in 
memoria il modulo principale e richiamare gli altri da disco, allocando per loro lo stesso 
spazio di memoria, che sarà di volta in volta a disposizione del modulo richiamato. Il 
modulo residente può chiamare le routine di qualunque altro modulo, ma gli altri 
possono chiamare solo le routine del modulo residente perché non possono risiedere 
contemporaneamente in memoria. L’applicazione può richiamare in memoria, in tempi 
brevissimi, il modulo da utilizzare, eseguire le necessarie operazioni ed eventualmente 
caricare il modulo successivo. Quando un’applicazione è suddivisa in moduli, si dice 
che è ‘gestita in overlay". 

Un file a struttura VLIR è un insieme di record, ognuno dei guadi può contenere un 
modulo dell’applicazione. Ogni record non è altro che una normale concatenazione di 
blocchi sequenziali. Un file a struttura VLIR può essere considerato come una 
collezione di diversi file. Le stesse routine che vengòno utilizzate per salvare su disco 
un normale file a struttura SEQUENTIAL possono essere impiegate per salvare i record 
di un file a struttura VLIR. Oltre a queste routine comuni alle due strutture, GEOS 
contiene diverse altre routine che sono riservate esclusivamente ai file a struttura 
VLIR. 

Le routine di gestione dei file a struttura VLIR allocano i settori del disco per i record 
facendo riferimento alla tavola degli indirizzi T/S dei settori (memorizzata general¬ 
mente nel buffer fileTrScTab), come avviene per i file normali. Ogni record non può 
quindi essere composto da più di 127 blocchi (32.258 byte), mentre la dimensione 
minima è di zero blocchi (record vuoto). La dimensione massima è sufficiente per 
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contenere perfino i codici che arrivano a impiegare la memoria del buffer di schermo, 
cioè che vengono allocati nello spazio di memoria che va da $0400 a $8000. La tavola 
indice, che abbiamo già menzionato nei precedenti capitoli, contiene i puntatori T/S 
che individuano il primo blocco di ogni record. La tavola che segue illustra la struttura 
fondamentale di un file VLIR, evidenziando l’organizzazione dei record nel file. 


Struttura dei file VLIR 
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VLIR è l’acronimo di Vaiiable Length Indexed Record (Record Indicizzati di 
Lunghezza Variabile). Sia le applicazioni sia le strutture di dati possono essere salvate 
in file VLIR. Per esempio, i file delle fonti caratteri (il tipo è FONT) sono file VLIR, nei 
quali ciascun record contiene i dati di un diverso corpo carattere. 

Un file a struttura VLIR può essere facilmente identificato andando a leggere il byte 
del File Entry che specifica i due possibili tipi: SEQUENTIAL o VLIR. Nel caso di una 
struttura VLIR, il File Entry contiene un puntatore T/S al blocco della tavola indice. 
Nel caso di una struttura SEQUENTIAL, questo puntatore indica il primo blocco del 
file. Per maggiori dettagli sui File Entry, si consulti il capitolo 13. 

La tavola indice, memorizzata in un blocco del disco, è in grado di contenere gli 
indirizzi T/S di 127 blocchi, numerati da 0 a 126. Dal momento che ogni blocco è Tinizio 
di un record, la tavola indice è in grado di indirizzare 127 record, numerati da 0 a 126. 
La prima word della tavola indice non viene impiegata, la seconda e le successive 
contengono i puntatori T/S ai 127 record. Il resto delle informazioni documentate nel 
File Entry e nel blocco File Header non sono diverse da quelle relative ai file a struttura 
SEQUENTIAL. 

Le routine per la gestione VLIR dei file 

GEQS prevede un particolare set di routine per la manipolazione dei file a struttura 
VLIR. Introduciamo il concetto di “puntatore al record corrente”. Dal momento che i 
record sono numerati, possiamo indicarli alle routine di gestione per mezzo di un 
puntatore numerico che ne riporta il numero d’ordine. Il record corrente può essere 
cancellato, letto o riscritto. A ogni accesso, l’applicazione si trova a gestire un intero 
record. Quindi le applicazioni devono riservare in memoria spazio sufficiente per la 
manipolazione di un record di dimensione massima (127 blocchi). Qwiamente se 
l'applicazione è stata realizzata per gestire insiemi di dati - o moduli - di dimensioni 
inferiori a quella massima, lo spazio riservato in memoria può essere anche molto 
minore. È possibile anche aggiungere record vuoti, che seguono o precedono un record 
preesistente nella lista. In effetti, dal momento che ciascuno è identificato da un 
numero d’ordine, non è necessario che record consecutivi da un punto di vista logico 
siano contigui nella tavola indice. Il numero d’ordine associato a un record (0 - 126) 
non è altro che il numero della word della tavola indice che lo indirizza. Per esempio, 
il record 0 è indirizzato dalla word 0 del blocco tavola indice (la prima word viene 
considerata in posizione -1 ). Per il momento non c’è la possibilità di separare un record 
e riconnetterlo altrove. DeleteRecord è distruttiva dal momento che disalloca tutti i 
settori del record e cancella il suo indirizzo dalla tavola indice. InsertRecord è in grado 
di lavorare solo con record vuoti. 

Mantenendo in memoria una copia della tavola indice, di solito nel buffer fileHeader, 
è possibile individuare un record direttamente, tramite la routine PointRecord, anziché 
scorrere avanti e indietro la lista dei record tramite le routine NextRecord e 
PreviousRecord. 
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Nella realizzazione delle routine di gestione dei record è stata posta particolare 
attenzione alla documentazione degli errori. Il prossimo paragrafo riporta una lista 
degli enori che si possono verificare manipolando i record di un file a struttura VLIR. 
I codici d’errore sono sempre restituiti nel registro x. Se una routine restituisce x - 0, 
significa che non si è verificato alcun errore. Una lista dettagliata dei possibili errori 
da disco è riportata in appendice. 


I messaggi d’mrore 

UNOPENED-VLIR 

Quésto errore si verifica quando si cerca di leggere/scrivere/cancellare/appendere 
un record di un file VLIR prima che il file sia stato aperto tramite la routine 
OpenRecordFile. 

INV-RECORD 

Questo errore si verifica quando si cerca di utilizzare una delle routine di lettura, 
scrittura e spostamento del puntatore con un record che non esiste (nella 
corrispondente word della tavola indice non è memorizzato alcrm indirizzo T/S). 
Questo errore non è fatale e si può lasciare che continui a verificarsi quando si desidera 
muovere il puntatore lungo la lista dei record. 

OUT_OF_RECQRDS 

Questo errore si verifica quando si cerca di inserire/appendere un record a un file 
che già contiene il massimo numero di record concesso (127 record, attualmente). 

STRUCT-MISMAT 

Questo errore si verifica quando viene utilizzata una routine in grado di manipolare 
un certo tipo di file per gestire file di tipo diverso. 
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Creaadone di un file a struttura VLIR 

Per prima cosa si procede alla creazione di un file VLIR vuoto, ricorrendo alla rotatine 
SaveFile. Il File Header da passare a SaveFile dovrebbe contenere le se.guenti 
informazioni: 


Tipo del File'C-64 
Struttura GEOS del File 
Per i File Dati: 

Indirizzo di Caricamento: 
Indirizzo di Fine File: 

Per le Applicazioni: 
Indirizzo di Caricamento: 

Indirizzo di Fine File: 


USER 

VLIR 

0 

$FFFF (-1 ), questo indirizzo insolito segnala a SaveFi¬ 
le che deve creare la struttura di un file VLIR vuoto 

locazione alla quale dev’essere caricato il primo record 
del file 

$FFFF (-1 ), questo indirizzo insolito segnala a SaveFi¬ 
le che deve creare la struttura di im file VLIR vuoto 


Questo è sufficiente per creare su disco un file VLIR con la tavola indice priva di 
record (vuota). Il puntatore ai record è impostato al valore -1: puntatore nullo. Prima 
di poter manipolare in qualsiasi modo un record del file, il file dev’essere aperto tramite 
la routine OpenRecordFile. Questa routine prepara i buffer interni di cui GEOS ha 
bisogno per manipolare il file. Se il file è completamente vuoto, cioè privo di record, 
il primo dev’essere creato tramite la routine AppendRecord. Dopo queste operazioni, 
si può passare all’esecuzione delle altre routine InsertRecord, AppendRecord e 
DeleteRecord. 

Quando l’applicazione non deve più compiere alcuna opereizione con i record del file, 
deve assolutamente chiuderlo tramite la routine CloseRecordFile. Questa routine 
aggiorna su disco la tavola indice, la RAM e il contatore dei blocchi contenuto nel File 
Entry. Attualmente GEOS non è in grado di gestire due file VLIR conteaiporaneamen- 
te. j 

Illustriamo ora nei dettagli le routine che permettono di gestire i file a struttura 
VLIR. 
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OpenRecordFile 


Funzione: Dopo aver ricevuto il nome di un file VLIR già esistente, questa routine lo 

apre, rendendolo cosi accessibile all’applicazione. 

Indirizzo: $0274 

Chiama: FindFile, GetBlock 

Parametri: rO puntatore alla stringa a terminazione nulla che contiene il 

nome del file 


Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 


Restituisce: 


X 

fileHeader 

usedRecords 

fileWritten 


curRecord 

dirEntryBuf 

curDirHead 


codice d’errore da disco 

questo buffer contiene la tavola indice del file 

numero di record di cui il file è composto 

questo flag indica se il file è stato ulteriormente modificato 

dopo l’ultima modifica nella BAM e nella tavola indice. Se vale 

0, nessuna modifica è stata effettuata 

puntatore ai record: se il file contiene almeno un record non 

vuoto, curRecord = 0, altrimenti (file vuoto) curRecord = -1 

questo buffer contiene una copia del File Entry del file 

questo buffer contiene una copia del Directory Header Block 

del file 


Distrugge: a, y, r1, r4 - r6 


Sinossi: OpenRecordFile prepara le variabili globali necessarie alle altre routine di 

manipolazione dei file VLIR per operare correttamente. OpenRecordFile 
chiama FindFile per scorrere la directory alla ricerca del file e, se il file viene 
trovato, verifica che abbia una struttura VLIR e imposta le variabili necessarie. 






Funzione: Aggiorna la tavola indice del file VLIR e la 6AM del disco. Segnala che non 

vi è alcun file aperto. 

Indirizzo: $C277 

Chiama: UpdateRecordFile 

Parametri: La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 

curRecord, fileWritten, fileHeader, curDirHead, dirEntryBuf (il buffer fileHea- 
der contiene la tavola indice) 

Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 

Restituisce: tavola indice aggiornata su disco 

BAM aggiornata su disco 

fileWritten impostato a 0 

File Entry se il file è stato modificato, la routine aggiorna il numero di 
blocchi usati per il file e aggiorna l’ora e la data copiando i 
valori correnti dalle variabili di sistema 

Distrugge: a, y, r1, r4, rS 

Sinossi: La routine chiama UpdateRecordFile per aggiornare la variabili su disco 

appena menzionate. Se il file è stato in qualche modo modificato, l’ora e la 
data vengono aggiornate con i valori di sistema correnti. La routine imposta 
un flag per indicare che non c’è nessun file VLIR aperto. 






Funzione: Aggiorna su disco la tavola indice, la 6AM, la data e l’ora associate al tue. 

Il file non viene chiuso. 


Indirizzo: $C295 

Chiamata da: CloseRecordFile 

Chiama: GeSlock, PutBlock 

Parametri: La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 

curRecord, fileWritten, fileHeader, curDirHead, dirEntryBuf (fileHeader 
contiene la tavola indice) 

Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDiive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 

Restituisce: tavola indice aggiornata su disco 

BAM aggiornata su disco 

fileWritten impostato a 0 

File Entry se il file è stato modificato, la routine aggiorna il numero di 
blocchi usati per il file e aggiorna l’ora e la data copiando i 
valori correnti dalle variabili di sistema 

Distrugge: a, y, r1,r4, r5 

Sinossi: UpdateRecordFile aggiorna su disco le variabili appena menzionate. Se il file 

ha subito qualche modifica, l’ora e la data memorizzate nel File Entry 
vengono aggiornate con i valori di sistema correnti. 
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PreviousRecord 

NextRecord 

PointRecord 


Funzione: Impostano il puntatore ai record in modo che punti rispettivamente al record 

che precede quello corrente, a quello che lo segue o a un particolare record 
del file VUR. 


Indirizzi: PreviousRecord $C27D 

NextRecord $C27A 

PointRecord $C280 


Parametri: a contiene il numero del record da puntare nel caso della 

routine PointRecord. Questo parametro non ha significato 
per le routine NextRecord e PrevbusRecord 
La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 
curRecord, fileWiitten, fileHeader, curDirHead, dirEntryBuf (fileHeader 
contiene la tavola indice) 


Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 


Restituisce: curRecord 

X 


y 


r1 

fileHeader 


numero del record corrente 
fiag d’errore nell’operazione: 

0 operazione effettuata con successo 
1 l’aggiornamento richiesto dei puntatore non è stato 
effettuato perché il puntatore si trova già al limite della 
tavola indice 

flag di file pieno: se vale 0 non è un segnale d’errore, ma 
indica che il record puntato è vuoto. Il valore attuale 
memorizzato in y rappresenta la traccia del record memoriz¬ 
zata nella tavola indice. Se il record è vuoto (non è composto 
da alcun blocco) in valore di y è zero 
l’indirizzo T/S del primo blocco del record correntemente 
puntato 
inalterato 
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Distrugge: 

Sinossi: 


Niente 

PreviousRecord, PointRecord e NextRecord variano il contenuto del 
puntatore ai record. Se si utilizza PointRecord si deve assegnare come 
parametro il numero del record. 

Muovendo il puntatore può verificarsi un errore, come per esempio 
avviene quando si chiama NextRecord e il puntatore già punta l’ultimo 
record. In questo caso viene passato in x il codice dell’errore, e il valore 
corrente del puntatore non subisce alcuna modifica. Se invece non si verifica 
alcun errore, viene caricato in r1 l’indirizzo T/S del primo blocco del record 
corrente, prelevato dalla tavola indice. r1L, la traccia nella quale si trova il 
primo blocco del record, viene copiata in y. Se y viene restituito con il valore 
0, significa che il record correntemente puntato è completamente vuoto. 
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DeleteRecord 

Funzione: 

Cancella il record correntemente puntato e sposta il puntatore (curRecord) 
al record successivo. 

Indirizzo: 

$C283 

Chiama: 

GetDirHead 

Parametri: 

La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 
curRecord, fileWritten, fileHeader, curOirHead, dirEntryBuf (fileHeader 
contiene la tavola indice) 

Preparazione 
del drive: 

Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 
BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 

Restituisce: 

X codice d’errore da disco 

curRecord punta al record successivo, o all’ultimo record nella lista 

Distrugge: 

a, y, rO - r9 

Sinossi: 

Il record corrente viene cancellato e il puntatore curRecord viene spostato 
al successivo. Se il record cancellato era l’ultimo del file VLIR, dopo la 
cancellazione il puntatore punta al nuovo “ultimo record”. 
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WriteRecord 


Funzione: Salva una particolare area di memoria aH’intemo del record corrente. 

Indirizzo: $C28F 


Chiama: GetDirHead, WriteFile, BIkAlloc 

Parametri: r2 numero di byte da salvare 

r7 indirizzo d’inizio in memoria deH’area da salvare 

La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 
curRecord, fileWritten, fileHeader, curDirHead, dirEntryBuf (fileHeader 
contiene la tavola indice) 

Preparazione 

dei drive: Attraverso SetDevice devono essere impostati curDiive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 


Restituisce: 


X 

fileHeader 

fileSize 

fileWritten 

fileTrScTab 

disco 

rSL 

r3 

curDirHead 


codice d’errore da disco 
contiene la tavola indice aggiornata 
dimensione in blocchi del record 

caricato con il valore $FF (-1) per indicare che il file, dal 

momento deH’apertura, ha subito una modifica 

tavola dei settori utilizzati p)er salvare il record 

il nuovo record salvato su disco 

numero di byte memorizzati nell’ultimo settore 

indirizzo T/S dell’ultimo settore allocato su disco 

copia della BAM, contenuta nel Directory Header Block, è 

stata modificata per documentare i nuovi settori allocati per il 

record. La routine non riscrive la Directory Header aggiornata 

su disco. Per farlo si utilizza PutDirHead 


Distrugge: a, y, rO - rS 

Sinossi: La routine alloca un’area della memoria su disco per un record. Il record può 

sovrapporsi a uno preesistente, che viene interamente e automaticamente 
cancellato. 

Attenzione: la routine cancella il record preesistente prima che il nuovo 
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record venga copiato, quindi se sul disco non c'è abbastanza spazio per 
contenere la nuova versione, il record originale viene perso ser^ che la 
nuova versione possa prendere il suo posto. Per ovviare a questo 
inconveniente, le applicazioni devono preventivamente chiamare la routine 
CaicBIksFree per assicurarsi che sul disco ci sia spazio sufficiente per 
contenere il record. La data e l’ora dell’ultima modifica vengono metnorìzzate 
su disco solo all’atto della chiusura del file. 
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ReadRecord 


Funzione: Trasferisce il record corrente in memoria. 

Indirizzo: $C28C 

Chiama: ReadFile 


Parametri: r2 numero massimo di byte che l’applicazione è in grado di 

ricevere e memorizzare. Se il record eccede lo spazio di 
memoria messo a disposizione daH’applicazione, si verifica 
l’errore BFR_OVERFLOW 

r7 indirizzo di nìemoria dal quale iniziare la memorizzazione del 

record 

La routine OpenRecordFile ha preparato le seguenti variabili: usedRecord, 
curRecord, fileWritten, fiieHeader, curDirHead, dirEntryBuf (fileHeader 
contiene la tavola indice) 

Preparazione 

del drive: Attraverso SetDevice devono essere impostati curDrive e curDevice, e la 

BAM del disco corrente dev’essere trasferita in memoria attraverso 
OpenDisk o NewDisk. 


Restituisce: 


X 

r7 

a 

fHeTrScTab 

r5L 

r1 


codice d’errpre da disco 

puntatore al byte che segue l’ultimo trasferito in memoria (se 

il record non è vuoto) 

flag di record vuoto: 0 = record vuoto 

tavola degli indirizzi T/S dei blocchi caricati da disco 

puntatore in fileTrScTab all’indirizzo T/S (word) dell’ultimo 

blocco caricato 

se si verifica l’errore BFR_OVERFLOW, r1 contiene l’indirizzo 
T/S del blocco che non è stato letto perché è stata raggiunta 
la massima capienza del buffer 


Distrugge: a, y, r1 - r4 


Sinossi: Il record corrente viene letto e trasferito in memoria nel buffer il cui indirizzo 

è specificato da r7. La routine aggiorna la tavola fileTrScTab. Le prime due 
word nella tavola fileTrScTab sono identiche: entrambe contengono 
l’indirizzo T/S del primo blocco del record. 






Funzione: Nella copia del blocco indice del file VLIR (mantenuta in memoria a 

fileHeader), InsertRecord inserisce un nuovo record vuoto nella posizione 
corrente, spostando in avanti tutti quelli che seguono. 

Indirizzo: $C286 

Parametri: curRecord individua il record alla cui posizione dev’essere inserito un 

nuovo record vuoto 

fileHeader deve contenere la copia del blocco indice del file VUR 

Restituisce: Il nuovo record alla posizione individuata da curRecord, e tutti i record che 
seguono spostati di una posizione in avanti 

Distrugge: a, x, y, rOL 

Sinossi: Nella copia del blocco indice del file VLIR (mantenuta in memoria a 

fileHeader), InsertRecord, a partire dai record individuato da curRecord 
compreso, sposta in avanti tutti i puntatori T/S dei record successivi di uno 
spazio puntatore (2 byte), creando così lo spazio per il puntatore a un nuovo 
record. Questo spazio viene generato in corrispondenza di curRecord, e 
viene aggiornato con i valori $00 e SFF per indicare che il record è vuoto. 

Il blocco indice conservato in memoria non viene riscritto su disco. 






Funzione: Dopo aver ricevuto tra i parametri la [X>sizione di curRecord, la routine crea 

uno spazio puntatore nella posizione immediatamente successiva. 

Indirizzo: $C289 


Parametri: curRecord individua il record dopo il quale dev’essere inserito un nuovo 

record vuoto 

fiieHeader deve contenere la copia del blocco indice del file VUR 

Restituisce: Il nuovo record nella posizione successiva a quella corrente 
curRecord punta al record appena inserito 

Distrugge: a, x, y, rOL 

Sinossi: Dopo aver ricevuto curRecord, la routine crea uno spazio puntatore nella 

posizione immediatamente successiva. Per creare lo spazio necessario, 
sposta in avanti tutti i record da curRecord+1 in poi. L’operazione viene 
eseguita nel buffer fiieHeader che dovrebbe contenere la copia del blocco 
indice del file VUR. In pratica, l’unica differenza con la precedente routine è 
che InsertRecord utilizza curRecord puntare la posizione in cui viene 
inserito il nuovo record vuoto, mentre AppendRecord si serve del puntatore 
per individuare il record dopo il quale deve inserire il nuovo record vuoto. 

Dopo^l’esecuzione della routine, curRecord punta al record vuoto appena 
inserito. 





J II I DRIVER 
1 O DI STAMPA 


Questo capitolo si rivolge in modo particolare ai programmatori che: 

1 ) desiderano utilizzare i driver di stampa GEOS nell’ambito delle loro applicazioni 
2) desiderano realizzare un driver di stampa GEOS in grado di comandare una 
stampante non ancora prevista da GEOS. 


L’attuale situazione delle st€unpanti 

Oggi sul mercato è presente una tale quantità di stampanti di ogni tipo che si 
dovrebbero scrivere ancora molti libri, oltre a quelli già pubblicati, per descriverne 
tutte le caratteristiche. Per ottenere le informazioni necessarie al funzionamento di una 
specifica stampante o di un’interfaccia, si deve consultare il manuale allegato in 
dotazione o rivolgersi al rivenditore ufficiale. 

Esistono in commercio due grandi categorie di stampanti; quelle “a caratteri” (per 
esempio, le stampanti a margherita o a globo rotante) e quelle “a matrice di punti". 
Le stampanti a caratteri utilizzano per la stampa caratteri solidi predefiniti. Quelle a 
margherita, per esempio, permettono di cambiare la margherita di caratteri per 
disporre di una fonte diversa, ma non offrono certo la possibilità di stampare qualsiasi 
tipo di carattere o forma geometrica. La loro maggior limitazione sta nell’impossibilità 
da parte del computer di definire via software il tipo di carattere. Non sono in grado, 
per esempio, di stampare una pagina in bit-map. Dal momento che GEOS lavora quasi 
esclusiveimente in alta risoluzione, tanto per i disegni quanto per i testi, le stampanti 
a caratteri non si prestano a essere utilizzate in ambiente GEOS. Per come è stato 
progettato e per l’uso a cui è destinato, GEOS richiede l’impiego di una stampante a 
matrice di punti. 
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Analizziamo il funzionamento di una stampante a matrice di punti. La testina di 
stampa è costituita da una linea verticale di punti, ciascuno dei quali può lasciare la 
sua impronta sulla carta. In una stampante ad aghi, la linea verticale è costituita da 
una serie di aghi che premono un nastro inchiostrato, generando sulla carta la stampa 
di un punto. In una stampante a getto, i punti sono generati invece da piccoli spruzzi 
d’inchiostro sulla carta. In entrambi i casi, il principio è Io stesso; la stampante lavora 
attivando opportunamente i punti della matrice monodimensionale verticale, ed è così 
in grado di ottenere qualunque tipo di disegno per i caratteri. La riga di stampa si 
ottiene con il movimento orizzontale della testina. Il software di gestione, che sia 
quello interno della stampante o che risieda nel computer, deve passare alla testina 
di stampa il disegno da riprodurre per ogni spazio carattere orizzontale. A ogni 
posizione orizzontale lungo la riga di stampa, la testina riproduce sulla carta i disegni 
ricevuti. Questi disegni possono venire da uno dei set di caratteri memorizzati su ROM 
aH’interno della stampante, o possono venire direttamente dal computer. Nel primo 
caso, la stampante richiede solo che il computer specifichi il codice ASCII del carattere, 
ottenuto il quale accede alla propria ROM caratteri per prelevare il disegno e passarlo 
alla testina di stampa. In questo modo il computer può far stampare solo i caratteri 
della fonte di cui è dotata la stampante. Nel secondo caso il computer ha il completo 
controllo del disegno da passare alla testina, e può quindi ottenere la stampa di 
qualunque figura. GEOS adotta questo secondo sistema. In realtà la maggior parte 
delle stampanti a matrice di punti ricevono il disegno da stampare come una matrice 
bidimensionale di pixel, ma la testina di stampa è composta da una sola linea verticale 
di punti che si muove orizzontalmente per creare un disegno bidimensionale. Nella 
figura che segue appare la linea verticale di punti della testina e due esempi di stampa. 
La testina si muove orizzontalmente generando la matrice di punti bidimensionale che 
costituisce il carattere. 


La generazione della matrice grafica bidimensionale 


Testina 

Caratteri stampati 


0 

--- 0 --- 

-0 . 

0 

-- 0 - 0 -- 

00 . 

0 

■ 0 --- 0 - 

-0 . 

0 

0000000 

-0 . 

0 

0 . 0 

-0 . 

0 

0 . 0 

-0 . 

0 

0 . 0 

000 ---- 
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La stampa in caratteri ASCII e quella in modo grafico 

Convenzionalmente le stampanti a matrice di punti si definiscono “grafiche" se oltre 
a stampare i codici ASCII che ricevono, sono anche in grado di stampare caratteri 
definiti direttamente dal computer. Nel caso dei codici ASCII, il computer riempie il 
buffer della stampante con i codici ASCII da stampare, e la stampante preleva il 
disegno di ogni carattere dal proprio set interno, dove sono memorizzate tutte le 
matrici di punti associate a ciascun carattere stampabile. Nel secondo caso, il 
computer ha la facoltà di passare alia stampante la matrice di punti volta per volta, 
riuscendo così a stampare qualsiasi forma grafica. 

Il set di caratteri interno della stampante viene utiUzzato sia nella stampa normale 
sia in quella “ad alta qualità" (near letter quality o NLQ). Si parla di stampa normale 
quando l’applicazione passa al driver di input una stringa di normali caratteri ASCII 
(non Commodore ASCII) da stampare, e la periferica li stampa con una sola passata 
orizzontale alla massima velocità, prelevando le matrici di punti dal set di caratteri 
interno memorizzato su ROM. In modo NLQ la stampante accede ancora alla ROM 
interna per prelevare le matrici di punti, ma la testina compie più di un passaggio sulla 
stessa riga per ottenere una migliore qualità di stampa (non si tratta comunque 
dell'unico metodo disponibile per ottenere la stampa in modo NLQ). 

GEOS normalmente seleziona il modo grafico per la stampa dei disegni e dei testi, 
in modo da poter stampare qpialsiasi tipo di fonte carattere. A seconda del tipo di 
stampante, il modo grafico può essere chiamato Graphics Mode, Bit-Image Mode o 
ARA Graphics Mode (All Point Addressable, punti tutti indirizzabili). Con quest'ultima 
tecnica la stampante interpreta i byte memorizzati nel buffer non come codici ASCII, 
ma come matrici monodimensionali verticali da passare alla testina di stampa. La 
tavola che riportiamo nella pagina seguente mostra un esempio di come una tipica 
testina può essere indirizzata nel modo grafico. A ogni punto della linea verticale è 
assegnato un bit. Nella tavola compaiono i valori esadecimali contenuti nel buffer di 
stampa e il loro effetto sui punti della testina. 
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Rappresentazione dei dati grafici su carta 


Bit assegnato 

Punti della 

Valori dei byte nel buffer e immagine 

al punto 

testina 

riprodotta su carta 





$01 $02 

$04 

$08 $10 $20 

$40 $80 

$fifl $55 $00 

0 

0 

0 

- 

- 

- 

0 

1 

0 

- 0 

- 

- 

- 

0 

2 

0 

- 

0 

- 

- 

0 

3 

0 

- 

- 

0 - 

- 

0 

4 

0 

- 

- 

- 0 - 

- 

0 

5 

0 

- 

- 

0 

- 

0 

6 

0 

- 

- 

- 

0 

0 

7 

0 

- 


. 

0 

0 


Stampanti a matrice di punti 

Sono presenti in commercio principalmente due categorie di testine a matrice di 
punti; quelle a 9 e quelle a 24 punti. Le stampanti dotate di testine a 9 punti, quando 
funzionano in modo grafico, indirizzano esclusivamente i punti più in alto, 7 o 8 punti 
a seconda del tipo di stampante. I punti più in basso sono di solito impiegati solo per 
creare i caratteri discendenti come la “g" e la “p”. Le stampanti a matrice di punti si 
possono differenziare anche sotto altri aspetti. Per esempio alcune possono assegnare 
il bit 0 del byte al primo punto in alto della testina, mentre altre possono assegnarlo 
all’ultimo punto in basso. Il driver di stampa deve tenere conto delle particolari 
caratteristiche della stampante che comanda, togliendo all’applicazione il problema di 
doversi preoccupare anche delle differenze tra una stampante e l’altra. Dal momento 
che il computer gestisce i dati a 8 bit più facilmente di quelli a 7 bit, la gestione delle 
stampanti dotate di testina a 7 punti verticali (modo grafico) può presentare alcuni 
problemi. Analizzeremo questi problemi quando introdurremo gli algoritmi di stampa. 
Per il momento ci limitiamo a una descrizione generale. 

Nella maggior parte dei casi, viene stampato un punto di altezza e larghezza pari a 
1/72 di pollice, separato dal punto contiguo lungo la verticale ancora di 1/72 di pollice. 
Le colonne di punti hanno di solito una distanza orizzontale pari a 1/60,1/72,1/80 di 
pollice, 0 anche meno, a seconda del tipo di stampante e del modo di stampa 
selezionato. 

Le stampanti con testina a 24 punti hanno fondamentalmente lo stesso 
funzionamento delle stampanti con testina a 9 punti. Possiedono ovviamente una 
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miglior risoluzione verticale (verticalmente ci sono 24 punti nello spazio che prima era 
occupata da soli 9 punti), mentre la risoluzione orizzontale rimane invariata. 

L'attivazione del modo grafico, e la conseguente disattivazione, avviene fondamen¬ 
talmente in due modi. Alcune stampanti, una volta ricevuto il comando di attivazione 
del modo grafico, rimangono in questo stato sino a quando non ricevono il comando 
di disattivazione. Altre stampanti richiedono l’invio del comando di attivazione del 
modo grafico seguito da un byte di conteggio; il modo grafico rimane attivo sino a 
quando la stampante non riceve il numero di byte specificato dal byte di conteggio. 

Quando la stampante cede all’applicazione il controllo dei punti della testina, 
quest’ultima deve indicare alla stampante anche quanto spazio dev’essere lasciato fra 
una linea e la successiva. Fortunatamente, le stampanti grafiche sono in grado di 
ricevere dal computer un comando di avanzamento della carta quando incontrano il 
carattere LF (Line Feed). Per parlare in modo un po’ più approfondito dei diversi 
metodi di stampa, è necessario innanzi tutto imparare a comunicare con la stampante. 


Le comunicazioni con la stampante 

Questo paragrafo descrive i compiti del bus seriale, e le routine disponibili nel Kernel 
del C-64 per la comunicazione con i dispositivi periferici. 

In genere il C-64 comunica con le sue periferiche (disk drive, stampanti...) attraverso 
il bus seriale. Questo bus è in grado di collegarsi a cinque dispositivi esterni 
simultaneamente. Il C-64 è il controllore del bus seriale e può impartire alle periferiche 
collegate tre tipi fondamentali di comandi: “control”, “talk” e “listen” (avviso di 
controllo, trasmetti, ricevi). Direttamente tramite il bus seriale, il C-64 può impartire 
alla periferica il comando “talk” (la periferica deve iniziare a trasmettere dati attraverso 
il bus), “listen” (la periferica deve porsi in ascolto per ricevere dati). Qgni dispositivo 
esterno è identificabile attraverso il suo numero o indirizzo di device (alcuni dispositivi 
permettono, con controlli hardware e software, che sia cambiato il loto numero di 
device). Quando il C-64 trasmette a tutte le periferiche collegate sul bus il comando 
“control”, esse rispondono trasmettendo il loro numero di device, cioè un byte che 
identifica il tipo di dispositivo. Nella maggior parte dei casi le stampanti a interfaccia 
seriale trasmettono sul bus il numero di device 4. Quando il C-64 seleziona il 
dispositivo che deve porsi in ascolto, tale dispositivo, per esempio la stampante, 
dev’essere in grado di riconoscere sul bus il proprio numero di device (4) e prelevare 
il byte successivo, che costituisce il comando vero e proprio. E naturalmente 
dev’essere in grado di riconoscere come un comando il secondo byte, che di solito 
viene chiamato “indirizzo secondario”. Per ottenere informazioni più precise sul 
funzionamento del bus seriale, consultare il volume Commodore 64, Guida di 
riferimento per il programmatore (Commodore Italiana). 

Il Kernel del C-64 contiene alcune routine destinate specificamente alle operazioni 
con il bus seriale. Queste routine, rispettivamente “talk”, “un-talk”, “listen” e 
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“un-listen”, trasmettono Tindirizzo secondario e quindi ricevono o trasmettono dati 
attraverso il bus seriale. In genere, all’atto della chiamata di una di queste routine, 
l'accumulatore deve contenere il numero di device per identificare la periferica. 
Quando terminano la loro esecuzione restituiscono nell’accumulatore lo stato 
dell’operazione effettuata {codice d’errore). Le routine del Kernel impostano a 1 il flag 
carry del PSW per indicare che il valore contenuto nell’accumulatore è un codice 
d’errore e non un numero casuale. I driver di stampa utilizzano queste routine primitive 
per attivare la trasmissione dei dati alla stampante attraverso la porta seriale. Per 
-ottenere ulteriori informazioni sulle routine del Kernel del C-64, si veda la Commodore 
64, Guida di riferimento per il programmatore (Commodore Italiana). 


Particolari sulle interfacce parallele 

Dal momento che la maggior parte delle stampanti di buona qualità non sono 
predisposte per essere collegate direttamente al bus seriale del C-64, anche perché 
molte utilizzano interfacce parallele Centronics, occorre un’interfaccia seriale-parallela 
in grado di convertire il protocollo di trasmissione utilizzato dal bus del C-64 nel 
protocollo Centronics e viceversa. Questi dispositivi sono da tempo disponibili sul 
mercato, e si possono rintracciare nei migliori negozi specializzati. 

I driver di stampa GEOS 

Ora che abbiamo analizzato gli aspetti più generali della comunicazione 
stampante-computer, possiamo procedere alla descrizione dei driver di stampa. Vi 
sono due esigenze fondamentali che devono essere soddisfatte perché una stampante 
sia in grado di dialogare con i diversi tipi di applicazione: 

1) tutte le applicazioni devono comunicare con il driver di stampa nello stesso 
modo 

2) il driver di stampa deve adattarsi alla stampante in maniera trasparente per 
l’applicazione. 

L’applicazione e il driver di stampa si dividono equamente il lavoro necessario per 
comunicare con la stampante. 


L’interiaccia per la stampa grafica 

I driver di stampa comunicano con le applicazioni tramite un buffer da 640 byte per 
il trasferimento dei dati. Questo buffer, chiamato buffer utente, è in grado di contenere 
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8 linee di scansione da 80 byte per linea (larghezza massima che GEOS è in grado di 
gestire), cioè 80 matrici grafiche. Alcune applicazioni prevedono pagine di larghezza 
più contenuta. Per esempio, in geoWrite V1.3 una riga non può superare i 60 byte. In 
questo caso l’applicazione deve preoccuparsi di inserire nel buffer un numero 
opportuno di byte azzerati su entrambi i lati di ogni linea di scansione in modo che 
la peirte significativa di ognuna venga ben centrata sul foglio. 

L’applicazione deve preparare un buffer di dati grafici organizzati in modo bit-map. 
Quando vengono memorizzati nel buffer, questi dati devono essere organizzati nello 
stesso formato non compatto che possiedono nelle schermate in alta risoluzione, e 
quindi per prima cosa è necessario espanderli. Il buffer contiene una riga della mappa 
grafica alta otto linee di scansione (riga grafica). Una volta che il buffer è pronto, 
l’applicazione deve chiamare la routine del driver di stampa appositamente 
predisposta per leggerlo, codificarlo e trasmetterlo alla stampante attraverso il bus 
seriale. Quello che serve al programmatore, quindi, è sapere qual è il formato di 
organizzeizione del buffer e quali routine ha a sua disposizione per comunicare con la 
stampante. Chi vuole realizzare un driver di stampa deve predisporre la serie di routine 
standard a cui tutte le applicazioni sono uniformate. Solo così l’applicazione può essere 
completamente indifferente al tipo di driver di stampa. È sufficiente che il driver 
possieda le routine standard e che gli entry point (punti di ingresso) di queste routine 
non varino da driver a driver. Qgni byte memorizzato nel buffer rappresenta 8 pixel 
orizzontali della mappa grafica. La stampante però si aspetta che il byte in arrivo 
rappresenti 8 pixel verticali, ed è quindi necessario che le routine del driver di stampa 
tengano conto di questa incompatibilità e provvedano alle dovute elaborazioni. La 
stampa di una linea grafica alta 8 pixel avviene utilizzando le seguenti routine. 


GetDimensions: Restituisce le dimensioni della pagina grafica che la stampante è 
in grado di gestire. Queste dimensioni sono espresse in spazi 
carattere Commodore (le dimensioni di un carattere sullo schermo 
del C-64). 

InitForPrint; Questa routine dev’essere eseguita per inizializzare la stampante 
prima di procedere alla stampa di un documento. Attualmente si 
esegue solo per impostare la velocità di trasmissione (baud rate). 

StartPrint; Inizializza il bus seriale prima della stampa di ogni pagina e apre 
un file logico di comunicazione con la stampante, in modo che si 
possano utilizzare le routine del Kernel del C-64 per trasferire i dati. 

PrintBuffer: Stampa in modo grafico il contenuto del buffer utente da 640 byte 

preparato dall’applicazione. 
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StopPrint: Gestisce le operazioni da effettuare quando viene determinato lo 

stato di fine pagina. Trasmette alla stampante il comando form 
feed (avanza a nuova pagina), e cancella dal buffer le linee di 
scansione che rimangono nel caso che la stampante stampi solo 7 
bit di ogni byte che riceve, avendo cura però di averle già 
stampate. 

L'applicazione ha il completo controllo della stampante. Essa chiama InitForPrint 
una sola volta per inizializzare la stampante. Per attivare il bus seriale deve eseguire 
la routine StartPrint. Prima di procedere alla stampa del documento, l’applicazione 
deve chiamare la routine GetDimensions per sapere qual è la larghezza massima 
consentita dalla stampante e il numero massimo di linee in una pagina. A questo punto 
può riempire il buffer utente con i dati della parte di mappa grafica da stampare e 
chiamare PrintBuffer per procedere alla stampa del buffer. Come già sottolineato, la 
parte di mappa grafica che si trasferisce nel buffer, cioè la riga grafica, deve avere lo 
stesso formato con cui viene memorizzata quando si deve visualizzarla sullo schermo 
ad alta risoluzione. L'applicazione continua questa procedura di aggiornamento del 
buffer e di successiva stampa fino a quando non ha stampato l’intera pagina. A questo 
punto dev’essere eseguita la routine StopPrint per far avanzare la carta della 
stampante fino alla pagina successiva ed eseguire le operazioni necessarie per la 
chiusura della pagina. Se l’applicazione deve stampare un’altra pagina, deve ripetere 
tutta la procedura iniziando di nuovo con una chiamata a StartPrint. 


La stampa dei caratteri ASCn 

La pagina di un documento stampato in caratteri ASCII è convenzionalmente larga 
80 caratteri e alta 66 linee. L’applicazione deve trasmettere al driver di stampa una 
stringa di caratteri ASCII a terminazione nulla. Qualsiasi formattazione e giustificazio¬ 
ne del testo, come raggiunta di spazi per inserire i tabulatori, dev’essere svolta 
dall’apphcazione. Ogni end of line (fine della riga) dev’essere segnalata al .driver di 
stampa attraverso il carattere CR (ritorno canello). Il driver trasmette quindi alla 
stampante il comando line feed, che muove la testina all’inizio della riga successiva. 
Per alcune applicazioni (geoPaint, per esempio ), non ha senso stampare documenti 
in caratteri o in NLQ (near letter quality). Per altre, invece, la cosa è possibile; ma in 
quest’ultimo caso gli eventuali caratteri di controllo presenti nel testo non devono 
essere trasmessi alla stampante. 

La procedura per la stampa in ASCII si avvicina molto a quella per la stampa grafica. 
Innanzi tutto l’applicazione deve chiamare InitForPrint per inizializzare la stampante. 
Quindi eseguire la routine SetNLQ per attivare il modo NLQ di stampa, e infine 
chieunare StartASCII per preparare il bus seriale (anziché StartPrint, come dovrebbe 
fare nel caso di stampa grafica). Solo allora l’applicazione può iniziare la vera e propria 
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trasmissione del testo al diìvet di stampa. Il testo è una stringa di caratteri a 
terminazione nulla puntata da rO. Al suo interno le singole linee devono essere 
separate da caratteri CR, e devono contenere gli spazi necessari per rimpaginazione. 


StartASCII; Utilizzata per la stampa in modo caratteri o NLQ. Per il resto è 
identica a StartPrint. 

PrintASCII; Fa le veci di PrintBuffer nel corso della stampa in modo caratteri 
o NLQ. L’applicazione non passa più al driver il buffer da 640 byte, 
ma una stringa di caratteri ASCII a terminazione nulla, e la 
stampante la visualizza su carta utilizzando il proprio set di 
caratteri. 


SetNLQ: Trasmette alla stampante la particolare stringa comando che attiva 

il modo NLQ. 


Le chiamate al driver da parte dell'applicazione 

I driver di stampa sono assemblati a partire dalTindirizzo PRINTBASE ($7900), e 
possono estendersi sino all’indirizzo $7F3F. Le applicazioni devono lasciare questo 
spazio di memoria libero per i driver. Al di fuori di quest’area, le applicazioni devono 
allocare spazio per due buffer: il primo viene utilizzato per passare al driver le 80 
matrici (640 byte) che compongono la linea grafica da 8 pixel in altezza e 80 byte in 
larghezza, il secondo (da 1920 byte) viene impiegato dal driver per le sue procedure 
interne. Questo secondo buffer, il buffer di stampa, è di dimensioni maggiori rispetto 
al primo in quanto alcuni driver di stampa, per migliorare l’efficienza o per comandare 
particolari stampanti, richiedono 1920 byte liberi per le loro procedure interne. Le 
applicazioni, per essere compatibili con tutti i driver possibili, devono rendere 
disponibili 1920 byte per il buffer di stampa. Quando l’applicazione chiama una routine 
del driver, i due buffer devono essere puntati rispettivamente da rO e ri. 

Qgni driver di stampa deve contenere, nella sua parte iniziale, una piccola jump 
table con gli indirizzi delle routine principali ad esso riservate. In questo modo le 
applicazioni possono chiamare le routine di stampa attraverso i punti d’ingresso 
presenti nella jump table, indipendentemente dal tipo di driver. 
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Jump table del driver di stampa 



.psect 

PRINTBASE 


InitForPrint ! 

jmp 

r-Ini tForPrint 

;priffia routine a PRINTBASE 

StartPrint; 

jmp 

r-StartPrint 

jseconda routine a PRINTBASE + 3 

PrintBuffer: 

jmp 

f-PrintBuffer 

jterza routine a PRINTBASE + 6 

StopPrint: 

jmp 

r-StopPrint 

;quarta routine a PRINTBASE + 9 

GetDimensions; 

jmp 

r-GetDimensions 

; quinta routine a PRINTBASE + 12 

PrintflSCII; 

jmp 

r-PrintfiSCII 

; sesta routine a PRINTBASE + 15 

StartflSCII ; 

jmp 

r_StartRSCI I 

jsettima routine a PRINTBASE + 18 

SetNLQ; 

jmp 

r-SetNLQ 

;ottava routine a PRINTBASE + 21 


La gestione del driver di stampa da parte 
dell’applicazione 

Ecco le procedure che le applicazioni devono seguire per effettuare la stampa di un 
documento in modo grafico o in modo caratteri ASCII. 

Per la stampa grafica: 

A. Si chiama GetDimensions (PRINTBASE + 12) per ottenere le seguenti 
informazioni: 

1) lunghezza massima della linea di stampa (individuata dalla costante 
CARDSWIDE), in genere 80 o 60. Questo valore viene restituito in x 

2) numero di righe in una pagina (individuato dalla costahte CARDSDEEP), che 
coincide con il numero delle chiamate a PrintBuffer. Questo valore viene re¬ 
stituito in y. 

B. Si chiama InitForPrint (PRINTBASE), a ogni nuovo documento, per inizializzare 
la stampante. Si chiama StartPrint (PRINTBASE + 3), a ogni nuova pagina, per 
aprire il file Commodore di output sul bus seriale. Se si verifica un errore, il carry 
viene impostato a 1 e x contiene il codice dell’errore. In caso contrario x contiene 
il valore 0. 
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C. Per stampare una linea si devono eseguire i passi seguenti: 

1) si memorizza la riga grafica (80 matrici) in un buffer da 640 byte e si aggiorna 
rO con l’indirizzo del buffer 

2) si ag0oma ri con l’indirizzo del secondo buffer da 1920 byte, che il driver 
utilizza internamente. Si aggiorna r2 con l’indirizzo della memoria colore per la 
riga. La testina delle stampanti a colori deve scandire la stessa riga più volte. 
Ogni scansione viene fatta in un colore diverso e con dati grafici diversi 

3) si chiama la routine PrintBuffer (PRINTBASE + 9). Nota: l’indirizzo puntato da 
ri dev’essere lo stesso durante tutta la stampa del documento e deve quindi 
rimanere inalterato fra una chiamata a PrintBuffer e la successiva. Il contenuto 
di rO e di r2 può invece cambiare a ogni chiamata. Eseguita quest’ultima 
operazione, si riprende dal punto 1 fino a quando la pagina non è stata 
interamente stampata. 

D. Alla fine di ogni pagina si chiama la routine StopPrint (PRINTBASE + 9), per 
“pulire” il buffer di stampa e chiudere il file Commodore di output. Se la stampante 
ha la testina da 7 punti verticali, le linee di scansione che restano nel buffer 
puntato da ri devono essere stampate, e non conservate per la successiva riga di 
dati. Questa routine trascina la carta fino all’inizio del nuovo foglio. 

Nota: CARDSWIDE è il numero di matrici grafiche in alta risoluzione utilizzate 
dalla stampante su una stessa linea. Ogni matrice grafica misura 8x8 pixel e 
quindi ha le dimensioni di uno spazio carattere. 

CARDSDEEP è il numero di righe grafiche in alta risoluzione utilizzate dalla 
stampante in un foglio. 


Per la stampa in caratteri ASCII: 

A. Si chiama InitForPrint (PRINTBASE) a ogni nuova pagina, per inizializzare la 
stampante. 

B. Si chiama SetNLQ (PRINTBASE + 21 ) se si desidera la stampa in modo near letter 
quality. 

C. Si chiama StartASCII (PRINTBASE + 18) a ogni nuova pagina, per aprire il file 
Commodore di output. Se si verifica un errore, il carry viene impostato a 1 e x 
contiene il codice dell’errore. In caso contrario x contiene il valore 0. 
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D. Per stampare una riga si devono eseguire i passi seguenti: 

1) si memorizza in un buffer il testo che si desidera stampare (la stringa di 
caratteri ASCII a terminazione nulla), e si aggiorna rO con l’indirizzo del buffer. 
Al termine di ogni linea dev’essere inserito il carattere CR perché alla stampante 
venga trasmesso il Line Feed 

2) si chiama la routine PrintASCII (PRINTBASE + 15). Eseguita quest’ultima 
operazione, si riprende dal punto 1 fino a quando la pagina non è stata 
interamente stampata. 

E. Alla fine di ogni pagina si chiama la routine StopPrint (PRINTBASE + 9), perché 
la stampante trascini la carta fino all’inizio del foglio successivo. Questa routine 
chiude anche il file Commodore di output. 

Iniziamo ora una dettagliata descrizione di tutte le routine sopra citate. 
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InitForPrìnt 


Funzione: 

Iniziaiizza la stampante per la stampa di un documento. Il protocollo 
d’inizializzazione dipende dal tipo di stampante. 

Indirizzo: 

$7900 (PRINTBASE) 

Parametri: 

Nessuno 

Restituisce: 

Niente 

Disfrugge: 

Dipende dal tipo di stampante 

Sinossi: 

InitForPrint è la prima routine da eseguire. Ha il compito di trasmettere alla 
stampante gli eventuali comandi speciali necessari per stampare documenti 
in formato GEOS. Con alcune stampanti non esegue alcuna operazione. 





Funzione: Restituisce le dimensioni in matrici grafiche del rettangolo che verrà 

stampato in un’area di 8 x 10,5 pollici della pagina. 

Indirizzo: $790C (PRINTBASE + 12) 

Parametri: Nessuno 

Restituisce: x larghezza della linea, in matrici grafiche 

y altezza del foglio, in righe grafiche (una riga grafica è alta quanto una 
matrice grafica) 

Distrugge: Niente 

Sinossi: GetDimensions fornisce informazioni sulle capacità di risoluzione della 

stampante in un’area di 8 x 10,5 pollici (le dimensioni del foglio di stampa). 
Alcune stampanti in commercio non possono stampare più di 60 punti per 
pollice e quindi non sono in grado di stampare l’intera riga grafica di GEOS 
(640 pixel). In questo caso l’applicazione deve decidere quale parte della 
pagina stampare e quale sacrificare. geoPaint, per esempio, stampa le prime 
60 matrici grafiche partendo da sinistra. geoWrite, invece, salta le prime 10 
matrici grafiche, lascia che il driver stampi le 60 matrici successive e taglia 
le ultime 10. Si stampano cioè solo le 60 matrici grafiche centrali, sebbene 
il documento ne contenga 80 per riga. 

GetDimensions fornisce in x la massima larghezza di linea possibile per 
la stampante, misurata in matrici grafiche (8x8 pixel): in y fornisce il numero 
che indica quante volte dev’essere riempito il buffer per completare una 
pagina grafica su carta (cioè il massimo numero di righe per ogni pagina; ogni 
riga è alta 8 pixel). Dopo aver aggiornato i registri x e y, accedendo a una 
tavola di valori memorizzata all’inizio dei codici del driver di stampa, 
GetDimensions ha finito il suo compito. 

Quando viene selezionato il modo a caratteri o NLQ, non è necessario 
chiamare GetDimensions. GEOS assume che ogni documento in caratteri 
ASCII debba essere stampato su fogli da 66 righe con 80 caratteri per riga. 






Funzione: Inizializza il bus seriale per comunicare con la stampante. Prepara la 

stampante alla ricezione di dati grafici. 

Indirizzo: $7903 (PRINTBASE + 3) 

Parametri: Nessuno 

Restituisce: x codice dell’eventuale errore 

Distrugge: Dipende dal tipo di stampante 

Sinossi: StartPrint serve ad aprire una struttura di fHe Commodore fittizia. Tramite 

questa struttura vengono trasmessi i dati alla stampante sul bus seriale. La 
struttura di file Commodore non viene realmente creata, ma si fa in modo che 
la stampante creda di ricevere i dati da un file. Vediamo come vengono 
utilizzate le routine del Kernel del C-64 per effettuare la comunicazione. Alla 
stampante è associato il numero di dispositivo 4. StartPrint chiama SetDevice 
per fare in modo che GEOS indirizzi la stampante. Quindi chiama InitForiO 
in modo che vengano disabilitati gli interrupt e attivati lo spazio di I/O e la 
ROM del Kernel del C-64. A questo punto StartPrint utilizza le primitive del 
Kernel del C-64 per simulare l’apertura di un file di comunicazione con la 
stampante. Le primitive del Kernel di GEOS restituiscono lo stato delle 
operazioni nella locazione $90. Se StartPrint vede che la locazione $90 non 
è azzerata, trasferisce il valore in essa contenuto nel registro x, chiude il file 
e restituisce il controllo all’applicazione. In questo modo il codice d’errore 
restituito in x corrisponde al numero restituito dalle primitive del Kernel del 
C-64. L’applicazione dev’essere in grado di gestire i due errori “Device Not 
Present" e “I/O Timeout Errors". Se invece il file è stato aperto con successo, 
la stampante riceve il comando di “mettersi in ascolto” sul bus seriale e gli 
altri comandi introduttivi di cui ha bisogno. Come ultima operazione, 
StartPrint ordina di cessare l’ascolto sul bus seriale e di eseguire la routine 
DoneWithIO per ripristinare la configurazione standard di sistema. A questo 
punto StartPrint restituisce il controllo all’applicazione, memorizzando nel 
registro x il valore 0 per indicare che non sono avvenuti errori durante lo 
svolgimento delle operazioni. Attenztone: se StartPrint ha avuto successo, 
la stampante si comporta come se fosse stato aperto un file Commodore, 
dal quale dovrebbe ricevere i dati. 





Funzione: Manda in esecuzione la stampa dell’intero buffer da 640 byte (80 matrici 

grafiche) contenente i dati grafici. 

Indirizzo: $7906 (PRINTBASE + 6) 

Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) che dev’essere 

stampato 

r1 indirizzo del buffer di stampa da 1920 byte che il driver utilizza 
internamente 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per le 
stampanti a 7 bit utilizzano questo buffer per non perdere le linee 
di scansione che restano dopo ogni chiamata di PrintBuffer. Infatti, 
a ogni chiamata di PrintBuffer vengono passate 8 linee di 
scansbne, ma soltanto 7 vengono stampate 

r2 indirizzo degli 80 byte della memoria colore per la matrice della riga 

Restituisce: rO, ri inalterati 

Distrugge: Tutti i registri 

Sinossi: PrintBuffer viene eseguita per stampare la linea grafica in aita risoluzione 

contenuta nei buffer puntato da rO (il buffer utente). Una linea grafica è 
composta da 80 matrici grafiche (8x8 pixel). La routine esegue nuovamente 
le chiamate alle routine SetDevice e InitForiO prima di ordinare alla stampante 
di “mettersi in ascolto’. Se la testina di stampa è in grado di stampare 8 punti 
contemporaneamente, PrintBuffer trasmette semplicemente il contenuto del 
buffer utente puntato da rO. 

Se invece la testina è in grado di stampare solo 7 punti contemporanea¬ 
mente, le operazioni da compiere sono più complesse dal momento che 
l’ultima linea di dati non può essere stampata. La prima chiamata a 
PrintBuffer serve per la stampa delle prime 7 linee di scansione contenute 
nel buffer. L’ultima linea viene tenuta per la prossima riga grafica. Alla 
seconda esecuzione di PrintBuffer, vengono stampate la linea rimasta e 6 
linee prelevate dal buffer utente, lasciando due linee nel buffer di stampa. Il 
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processo di stampa continua nello stesso modo finché le linee conservate 
nel buffer di stampa diventano 8, cioè sono state stampate 7*8 * 56 linee 
di scansione. Ora la routine deve stamparle come una normale riga grafica, 
che però non è stata passata dall’applicazione, ma rappresenta un accumulo 
di dati creato da Pr^tBuffer. Staiiipando questa eccedenza di 8 linee di 
scansione, viene prodotto un nuovo accumulo di una linea grafica. Quindi il 
ciclo riprende dalla condizione iniziale, ma con un riporto composto da una 
linea di scansione. 

Quindi per compiere il necessario riallineamento con le linee grafiche in 
input ogni 56 linee di scansione stampate (8 righe grafiche * 7 linee 
stampate), PrintBuffer stampa la riga grafica accumulata prima di prendere 
in considerazione la nuova riga grafica in input. Il ciclo a questo punto 
riprende, ma non dall’inizio. Infatti ora alla nuova riga grafica ricevuta 
dall’utente si aggiunge il riporto della linea di scansione rimasta dopo l’ultimo 
svuotamento del buffer di stampa. L’algoritmo di stampa per le stampanti a 
7 bit verrà meglio illustrato più avanti. 

Dopo aver stampato un’intera riga grafica, PrintBuffer trasmette alia 
stampante il carattere CR (ritomo carrello), e il carattere LF (avanza alla riga 
successiva) se la stampante lo richiede. In seguito trasmette il comando di 
terminare l’ascolto sul bus e chiama la routine DoneWithlQ per riportare il 
sistema allo stato precedente alla chiamata. Per ottenere maggiori dettagli 
si vedano i due esempi di driver di stampa nei prossimi paragrafi. 
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Funzione: Questa routine dev’essere eseguita dopo la stampa di ogni pagina, per 

cancellare il buffer di output e comandare alla stampante di trascinare la carta 
a pagina nuova. 

indirizzo: $7909 (PRINTBASE + 9) 

Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) utilizzato per 

passare le righe grafiche al driver 

r1 indirizzo del buffer di stampa da 1920 byte che il driver utilizza 
internamente 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per 
le stampanti a 7 bit utilizzano questo buffer per non perdere 
le linee di scansione accumulate dopo ogni chiamata di 
Prinffiuffer. In questo caso, a ogni chiamata di PrintBuffer 
vengono passate alla stampante 8 linee di scansione, ma solo 
7 vengono stampate 

Restituisce: rO, ri inalterato 

Distrugge: Tutti ì registri 

Sinossi: StopPrint si esegue quando tutte le righe grafiche che compongono una 

pagina sono state stampate. Esegue le seguenti operazioni; chiama 
SetDevice, InitForlO, e ordina alla stampante di mettersi in gecolto sul bus 
seriale. Se la stampante ha la testina da 7 punti, la routine svuota il buffer di 
stampa stampando le eventuali linee di scansione accumulate. Quindi 
avanza la carta alia nuova pagina, comanda alla stampante di cessare 
l’ascolto sul bus, chiude il file Commodore di output fittizio ed esegue la 
routine DoneWithlO. 
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Funzione: Inizializza il bus seiiaJe per comunicare con la stampante. Prepara la 

stampante alla ricezione di codici ASCII da stampare con il proprio set interno 
di caratteri. 


Indirizzo: $7912 (PRINTBASE + 18) 

Parametri: Nessuno 

Restituisce: a, x, y, r3 

Distrugge: Dipende dal tipo di stampante 

Sinossi: StartASCII effettua operazioni molto simili a quelle compiute da StartPrint, 

cioè apre un file Commodore di output fittizio, in modo che la stampante 
creda di ricevere i dati da un fiie logico. Grazie a questo artificio possono 
essere utilizzate le routine del Kernel del C-64 per le comunicazioni con la 
stampante. Anziché in modo grafico, la stampante viene inizializzata per 
ricevere codici ASCII. Per maggiori dettagli si veda la scheda di StartPrint. 






Funzione: Stampa la stringa ASCII a terminazione nulla puntata da rO. 

Indirizzo: $790F (PRINTBASE + 15) 

Parametri: rO contiene il puntatore alla stringa ASCII 

Restituisce: Niente 
Distrugge: Tutti i registri 

Sinossi: PrintASCII viene eseguita per stampare un’intera stringa ASCII a terminazione 

nulla tramite il set di caratteri residente nella stampante. La stringa viene 
memc»izzata nel buffer utente e puntata da rO. La routine ritiene conclusa la 
stampa della stringa quando incontra il carattere NULL (0). Non ci sono 
quindi Hmiti alla lunghezza della stringa. AH’intemo della strìnga possono 
essere presenti caratteri CR per indicare la fine di una riga e l’inizio della riga 
seguente. Per alcune stampanti, la routine trasmette anche il carattere LF 
(avanza riga successiva) quando incontra il carattere CR. 

Dopo aver stampato un’intera stringa ASCII, la routine ordina alla 
stampante di cessare l’ascolto, e chiama DoneWithIO per riportare il sistema 
alla configurazione precedente. 
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n driver per le stampanti a 8 punti 

Ecco la descrizione di un driver per stampanti a 8 pimti. Per quanto questo driver 
impieghi esclusivamente il buffer utente da 640 byte, nelle schede viene sempre 
indicato fra i parametri un bufiler di stampa da 1920 byte. Questo accade in quanto 
l’applicazione non è tenuta a sapere quale driver è stato selezionato, e deve quindi 
adattarsi alle esigenze generiche di tutti i driver. In linea di principio, il funzionamento 
di questo driver è molto semplice. 

L’applicazione, dopo aver chiamato InitForPrint e StartPrint, deve preparare il buffer 
utente e cederne l’indirizzo a PrintBuffer. Questa routine apre il canale di 
comunicazione con la stampante e chiama PrintPrintBuffer. Quest’ultima è il cuore 
della stampa. Per prima cosa controlla quante matrici grafiche della riga sono azzerate, 
scorrendo la riga da destra verso sinistra. Questa operazione, eseguita da TestBuffer, 
permette a PrintPrintBuffer di ottimizzare la stampa della riga grafica evitando di 
stampare tutta la riga quando solo la parte iniziale contiene matrici grafiche 
significative. 

A questo punto PrintPrintBuffer procede alla stampa delle matrici grafiche 
significative. Qgni matrice, prima di essere trasmessa alla stampante tramite la 
routine SendBuff, viene opportunamente ruotata in modo che ogni byte non 
conisponda più a una riga orizzontale, ma a una linea verticale di 8 bit. Questa 
rotazione è necessaria dal momento che la testina di stampa rappresenta su carta i byte 
che riceve verticalmente. 

Questo è l’algoritmo di stampa che normalmente si impiega per comandare le 
stampanti a 8 punti. Nel prossimo capitolo verrà illustrato l’algoritmo più complesso 
per le stampanti a 7 punti. 

Questo driver è stato ideato per le stampanti; 

EPSON FX-80, FX-lOO, RX-80, RX-lOO, JX-80 

PANASONIC KX-1091, KX-1092, KX-1592, KX-1595 

ed è stato sottoposto al test di verifica utilizzando la stampante; 

EPSON JX-80. 

Nella pagina successiva viene presentato il listato del file sorgente utilizzato per il 
nostro driver di stampa. 
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U __ 

Costanti per la stampante 

-99 


TRfìNSPflRENT 

CRRDSUIDE 

CfìRDSDEEP 

SECfiDD 

PRINTflDOR 

PRINTBflSE 

ESC 


5 

80 

90 

TRflNSPflRENT 

4 

$7900 

$1B 


;coffianclo che non effettua alcuna operazione 
)80 matrici grafiche Commodore di larghezza 
;90 matrici grafiche Commodore di altezza 
; indirizzo secondario 
;numero di dispositivo della stampante 
{indirizzo al quale il driver dev'essere rilocato 
{codice escape della stampante 


, include 
. include 
.include 
.include 


geosMacros 

geosConstants 

geosflemorgMap 

geosRoutines 


{per questi file si veda l'appendice 
{macro per l'Rssembler della Berkeley 
{costanti 

{locazioni e variabili nella RRh 
{jump table per le routine di GEOS 


.psect PRINTBflSE 


{indirizzo al quale allocare il file oggetto 
{compilato 


U - 

Jump table residente 


99 


InitForPrinti 

rts 


{prima routine a PRINTBflSE 


nop 


{per questa stampante la routine non deve 


nop 


{compiere nessuna operazione 

StartPrint; 

jmp 

r-StartPrint 

{seconda routine a PRINTBflSE + 3 

PrintBufferi 

jmp 

r.PrintBuffer 

{terza routine a PRINTBflSE + 6 

StopPrinti 

jmp 

r-StopPrint 

{quarta routine a PRINTBflSE + 9 

GetDimensionsi 

Jmp 

r-GetOimensions 

{quinta routine a PRINTBflSE + 12 

PrintflSCII; 

jmp 

r-PrintflSCII 

{sesta routine a PRINTBflSE + 15 

StartflSCII: 

jmp 

r-StartflSCII 

{settima routine a PRINTBflSE + 18 

SetNLQi 

jmp 

r.SetNL0 

{Ottava routine a PRINTBflSE + 21 
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U _ 

Variabili in RAM e utility 

-99 

printerNamei .byte "Epson FX-80", 0 ;noffle della stampante come dovrebbe apparire 

jnel menu di selezione della stampante 
prntBlCard; .byte 0, d, 0, 0, 8, 0, 0 ;matrice grafica stampabile 

breakCount: .byte 8 ^contatore linee avanzate 

sCounti .byte 8 (contatore delle linee all'interno 

(della matrice grafica corrente 

cardCounti .byte 0 (contatore delle matrici grafiche azzerate 

(a fine riga 

modeFlag! .byte 8 ($00=stampa grafica, $FF=stampa ASCII 

.include geosUtilities (file contenente routine di basso livello per 1 

(comunicazione con la stampante. Questo file e' 
(riportato alla fine del capitolo 
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Le routine direttamente accessibili 
dall’applicazione 

GetDimensions 

Funzione: 

Restituisce le dimensioni (in matrici grafiche) del disegno che la stampante 
è in grado di riprodurre sul fogito. 

Parametri: 

Nessuno 

Restituisce: 

X larghezza massima (in matrici grafiche) della linea che la stampante è 
in grado di stampare 

y altezza massima (in matrici grafiche) dello spazio lungo il foglio entro il 
quale la stampante è in grado di stampare 

Dismigge: 

Niente 

Sinossi: 

GetDimensions informa sul numero di matrici grafiche che la stampante è in 
grado di stampare nel sotto-rettangolo di 8 x 10,5 pollici. Il sotto-rettangolo 
è compreso interamente nel foglio di stampa, che normalmente misura 8,5 
X 11 pollici. 


r-GetDinensionsi 


Idx 

«CRROSUIDE 

;nunero di 

natrici grafiche 

orizzontali 

Idy 

#Cf)ROSDEEP 

;nuiiero di 

natrici grafiche 

verticali 

Ida 

rts 

«e 

1 iMpostato 

a 0 per i driver 

grafici 
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StartPrìnt 


Funzione: 

Realizza la necessaria iniziaiizzazione della stampante all’inizio di ogni 
pagina del documento. 

Parametri: 

Nessuno 

Restituisce: 

X 0 se la stampante non è accessibile 

Distrugge: 

Tutti i registri 

Sinossi: 

Questa routine prepara per la stampa di una pagina il bus seriale e la 
stampante. La stampante viene configurata opportunamente per ricevere 
dati grafici. 


r-StartPrint i 


Ida 

«0 

jimposta il modo grafico 

sta 

Startlni 

modeFlag 


Ida 

♦PRINTflDDR 

(■attiva il dispositivo 4 

jsr 

SetDevice 


jsr 

InitForlO 

)attiva il Kernel del C-64( lo spazio di I/O e 
;disabilita gli interrupt 

Ida 

♦0 


sta 

190 

; imposta l'indicatore d'errore a nessun errore 

jsr 

OpenFile 

japre il file fittizio di comunicazione 
;con la stampante 

Ida 

$90 

jse si e' verificato un errore con il canale 
;di output, esegui 

bne 

20$ 

jla routine di gestione degli errori 

Jsr 

OpenPrint 

;apre il canale con la stampante 

Jsr 

InitPrinter 

jinizializza la stampante in modo grafico 

Jsr 

ClosePrint 

;chiude il canale con la stampante 

Jsr 

Delay 

jattende per eliminare eventuali problemi di 
;temporizzazione 

Jsr 

DoneUithIO 

;ripristina lo stato precedente alla chiamata 
;di InitForlO 
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Idx 

#0 

rts 


20$: 


pha 



jsr 

jsr 

pia 
tax 
rts 
Delay! 

Idx 

18$: 

Idy 

20 $: 

dey 

bne 

dex 

bne 

rts 


CloseFile 

DoneMithIO 


«0 

*0 

20 $ 

10$ 


;nessun errore 


; salva temporaneamente il codice 

jdell'eventuale errore 

;bit 0 impostato a 1: timeout, scrittura 

;bit 7 impostato a 1: dispositivo non presente 

jchiude il file 

jripristina lo stato precedente alla chiamata 
idi InitForlO 

irecupera il codice dell'errore 
ie lo trasferisce in x 
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StartASCII 


Funzione: 

Inizializza la stampante Epson in modo che tratti i dati trasmessi come codici 
ASCII. 

Parametri: 

Nessuno 

Restituisce: 

Niente 

Distrugge: 

Tutti i registri 

Sinossi: 

Imposta il flag modeFlag per indicare la selezione del modo ASCII di stampa. 
Chiama Startin per procedere all’inizializzazione. Questa routine dev’essere 
chiamata all'inizio di ogni nuova pagina. 


r-SlartflSCII 1 
LoadB 
jmp 


modeFlag, #$FF 
Startln 


jimposta il modo RSCII di stampa 

jutilizza una parte di StartPrint per procedere 

;alla preparazione della stampante 
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SetNLQ 


Funzione: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Inizializza la stampante Epson nel modo near letter quality. 

Nessuno 

Niente 

Tutti i registri 

Trasmette alla stampante la stringa comando necessaria per selezionare il 
modo NLQ di stampa. 


r-SetNLQ; 



Ida 

tPRINTftODR 


jsr 

SetDevice 

,‘attiva il dispositivo associato 

jsr 

InitForlO 

;attiva il Kernel del C-64, lo spazio di I/O 
;e disabilita gli interrupt 

jsr 

OpenPrint 

;apre il canale con la stampante 

LoadU 

r3, #nlqTbl 

; tavola dei byte d'inizializzazione 
;da trasmettere 

Ida 

#(enlqTbl-nlqTbl) 

; lunghezza della tavola 

Jsr 

Strout 

jtrasmette la tavola alla stampante 

Jsr 

ClosePrint 

;chiude il canale con la stampante 

Jsr 

DoneUithlO 

jripristina lo stato precedente 
;alla chiamata di InitForlO 

rts 




nUTbl! 

.byte 147, ESC, $45, ESC jquesti byte, trasaessi da destra verso sinistra, 

;coaandano alla stampante di abilitare 
jil aodo NLQ 

enlqTbli jfine della stringa comando per attivare 

; il modo NLQ 
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PrìntASCII 


Funzione: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Trasmette alia stampante una strìnga ASCII a terminazione nulla. 

rO puntatore alla strìnga ASCII 

Niente 

Tutti i registri 

Trasmette la strìnga ASCII a terminazione nulla puntata da rO. La strìnga può 
contenere caratteri CR per la separazione delie linee. La routine, quando 
incontra il carattere CR, trasmette di seguito anche il carattere LF. 


r-PrintASCII 1 

Ida 

#PRINTADDR 

Jsr 

SetOevice 

jsr 

InitForlO 

jsr 

OpenPrint 

10$: 

Idy 

#0 

Ida 

(r0), y 

beq 

30$ 

cmp 

#CR 

bne 

20$ 

Jsr 

Ciout 

Ida 

#LF 

20$: 

jsr 

Ciout 

IncU 

r0 

jmp 

10$ 

30$: 

jsr 

ClosePrint 

jsr 

DoneUithIO 

rts 


jattiva il dispositivo associato 

;attiva il Kernel del C-64, lo spazio di I/O 

je disabilita gli interrupt 

japre il canale con la staopante 

jazzera l'indice per scorrere la stringa ASCII 
jpreleva il carattere 

;se raggiunge la fine della stringa, termina 
;se e' un CR aggiunge anche un LF 
jsalta se non e' un CR 
jtrasmette il carattere 
jtrasmette il LF 


;punta al carattere successivo 
; ripete il loop 

jchiude il canale con la stampante 
)ripristina lo stato precedente 
;alla chiamata di InitForlO 






Funzione: Trasmette i dati grafici contenuti all’intemo del buffer da 640 byte (80 matrici 

grafiche) creato dall’applicazione. 

Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) 

r1 indirizzo del buffer di stampa da 1920 byte che l’applicazione deve 
mettere a disposizione del driver per suo uso interno 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per le 
stampanti a 7 bit utilizzano questo buffer per non perdere le linee 
di scansione accumulate a ogni chiamata di PrintBuffer 

Restituisce: rO, ri inalterati 

Distrugge: Tutti i registri 

Sinossi: PrintBuffer, come è già stato spiegato, è la routine di livello più alto in grado 

di trasferire il contenuto del buffer da 640 byte dalla memoria del C-64 alla 
stampante attraverso la porta seriale. 


r-PrintBufferi 


Ida 

«PRINTflDDR 


jsr 

SetDevice 

;attiva il dispositivo associato 

jsr 

InitForlO 

jattiva il Kernel del C-64, lo spazio di I/O 
;e disabilita gli interrupt 

jsr 

OpenPrint 

japre il canale di comunicazione con la stampante 

MoveW 

r0, r3 


jsr 

PrintPrintBuffer 

trasmette la riga grafica alta 8 bit memorizzata 
;nel buffer utente 

jsr 

Greturn 

trasmette i caratteri CR e LF 

jsr 

ClosePrint 

jchiude il canale di comunicazione 
;con la stampante 

jsr 

rts 

DoneUithIO 

jripristina lo stato precedente alla chiamata 
;di InitForlO 







Funzione: Viene eseguita dopo la stampa di ogni pagina, per cancellare il buffer di 

stampa e comandare alla stampante di far avanzare la carta fino al foglio 
successivo. 


Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) 

r1 indirizzo del buffer di stampa da 1920 byte che l’applicazione deve 
mettere a disposizione del driver per suo uso interno 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per le 
stampanti a 7 bit utilizzano questo buffer per non perdere le linee 
di scansione accumulate a ogni chiamata di PrintBuffer 

Restituisce: rO, ri inalterati 

Distrugge: In genere tutti i registri 

Sinossi: StopPrint dev’essere chiamata quando è finita la stampa di una pagina. 

Manda in esecuzione SetDevice, InitForlO, mette in ascolto la stampante, e 
se la testina è a 7 bit stampa le eventuali linee rimaste nel buffer di stampa. 
Infine la routine effettua l’avanzamento del foglio all’inizio della nuova pagina, 
comanda alla stampante di cessare l’ascolto sul bus seriale, chiude il file 
Commodore di output ed esegue la routine DoneWithiO. 


r-StopPrint i 


Ida 

#PRINTflDOR 


jsr 

SetDevice 

jattiva il dispositivo associato 

jsr 

InitForlO 

jattiva il Kernel del C-64, lo spazio di I/O 
;e disabilita gli interrupt 

jsr 

OpenPrint 

;apre il canale con la stampante 

jsr 

FormFeed 

;fa avanzare la carta fino al nuovo foglio 

jsr 

ClosePrint 

;chiude il canale di stampa 

jsr 

CloseFile 

schiude il file di output 

jsr 

DoneUithIO 

;ripristina lo stato precedente alla chiamata 
;di InitForlO 

rts 
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Le routine interne del driver 

PrìntPrìntBuffer 

Funzione: 

Trasmette il buffer di stampa puntato da r3. 

Chiamato da: 

PrintBuffer 

Parametri: 

r3 indirizzo del buffer in memoria 

Restituisce: 

Niente 

Distrugge: 

a, X. y, rO - r15 

Sinossi: 

Controlla se il buffer è vuoto, tramite TestBuffer, prima di procedere alla 
stampa della riga grafica. Se il buffer non è vuoto, la routine, per ogni matrice 
grafica prelevata dal buffer, la ruotare" i byte e li trasmette alla stampante. 
TestBuffer comunica in cardCount quante sono le matrici grafiche azzerate 
a partire dal lato destro della riga grafica. PrintPrin©uffer, valutando 
opportunamente cardCount, è in grado di ottimizzare il tempo di stampa 
trasmettendo esclusivamente le matrici grafiche significative di ogni riga. 


PrintPrintBuffer; 


PushM 

r3 

;salva il puntatore al buffer 

jsr 

TestBuffer 

jcontrolla se il buffer e' coapletaliente azzerato 
;e aggiorna cardCount 

bcs 

5$ 

;se il buffer contiene dati inizia il trasferiaento 

PopM 

rts 

r3 

jaltrinenti svuota lo stack e termina 

jsr 

SetGraphics 

cattiva il modo grafico per la riga corrente 

PopW 

r3 

jrecupera il puntatore alla natrice 
;grafica corrente 

Ida 

«CRRDSUIDE 

jcarica la larghezza della riga grafica 
;supportata dalla stampante (generalmente 80) 
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sec 

sbc 

tax 

18$: 

txa 

pha 

jsr 

jsr 

RddVU 

pia 

tax 

dex 

bne 


cardCount 


Rotate 
SendBuff 
#8, r3 


18$ 


rts 


^sottrae il nuaero di nappe grafiche nulle 
;a partire dal lato destro della riga grafica 
jottenendo l'esatto nunero di natrici grafiche 
;significative della riga grafica corrente 

j salva X 

jruota la natrice grafica puntata da r3 
; trasnette la natrice grafica ruotata 
;aggiorna r3 in nodo che punti alla natrice 
jgrafica successiva 
jrecupera x 


ise non ha trasnesso tutte le natrici grafiche 
iriesegue l'operazione con la successiva 
;natrice presente nel buffer 




414 GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 



Funzione: Controlla se il buffer contiene dati grafici da stampare. TestBuffer restituisce 

in cardCount il numero di matrici grafiche azzerate che incontra lungo la riga 
grafica scorrendola da destra a sinistra. L’informazione permette a 
PrintPrintBuffer di non perdere tempo a trasmettere le matrici grafiche 
azzerate che completano la riga grafica. 

Chiamata da: PrintPrintBuffer 

Parametri: r3 puntatore all’inizio del buffer da controllare 

Restihiisce: C impostato a 1 se il buffer contiene dei dati, impostato a 0 se il buffer 

è vuoto 

Distrugge: a, x, r3 

Sinossi: Controlla i byte contenuti nel buffer per accertarsi che non siano tutti a 0. il 

controllo inizia dal lato destro della riga grafica e procede verso sinistra, 
matrice per matrice. Durante la scansione delle matrici grafiche, la routine 
mantiene aggiornato il contatore cardCount. Quando incontra un byte 
diverso da zero, la routine termina la scansione, imposta a 1 il carry ed esce. 
Quindi cardCount contiene il numero di matrici grafiche completamente 
azzerate presenti nella riga grafica da destra a sinistra. Se invece la routine 
non incontra alcun byte diverso da zero, esce impostando il carry a 0. 


TestBufferi 


LoadG 

cardCount, #0 

;azzera il contatore delle tuatrici grafiche 
jazzerate 

Idx 

#7 

jassume che la testina di stampa sia da 8 punti 

stx 

sCount 

;aggiorna il contatore di linee di scansione 
jaH'interno della matrice grafica 

Mm 

#((CflRDSWIDE-l)*8), r3 

;aggiorna r3 in modo che punti al primo byte 
idell'ultima matrice grafica lungo la riga 

Idx 

♦CflRDSWIDE 

;aggiorna x con il numero di matrici grafiche 
;presenti in una riga 
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10$: 

Idy 

sCount 

jpreleva il eontatore di linee aH'interno della 
)»atriie grafica corrente 

20$: 

Ida 

(r3), y 

; control la un byte 

biìe 

30$ 

;se e' diverso da 0 l'esecuzione 
;della routine termina 

dey 


;punta al precedente byte nella matrice grafica 

bpl 

20$ 

;se non ha finito la scansione della matrice grafica 
;corrente, controlla il byte precedente 

SubVU 

#8, r3 

jaggiorna r3 in modo che punti all'inizio 
;della matrice grafica precedente 

ine 

eardCount 

; incrementa il contatore delle matrici grafiche 
;azzerate 

dex 


ise non sono state controllate tutte le matrici 
jgrafiche della riga 

bne 

10$ 

;vai a verificare la precedente 

eie 


jse la routine termina con questa istruzione, 
jsignifica che il buffer e' vuoto 

rts 

30$: 

see 


jimposta il carry a 1 per indicare che il buffer 



;non e' vuoto 

rts 
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InitPrìnter 


Funzione: Inizializza la stampante Epson in modo che utilizzi un'interlinea da 8/72 di 

pollice se viene attivato il modo grafico, o da 6 linee per pollice se viene 
attivato il modo ASCII. 


Chiamata da: StartPrint 

Parametri: modeFlag 0 - modo grafico, $FF - modo ASCII 

Restituisce: r3 #initTbl nel modo grafico, #ainitTbl nel modo ASQI 

sCount $FF 

y 0 

Distrugge: a 

Sinossi: Questa routine ha a disposizione due diverse stringhe comando, a seconda 

che venga selezionato il modo di stampa grafico o quello ASCII. L’opportuna 
stringa viene inviata alla stampante per l'inizializzazione. Per ottenere 
maggiori dettagli sulla sintassi dei due comandi, si deve consultare il manuale 
della stampante. 


InitPrinter: 

bit 

bai 

LoadM 

Ida 

jap 

10 $: 

LoadU 

Ida 

jap 

initTbl : 
.byte 
.byte 
einitTbl: 
ainitTbl: 
.byte 
.byte 

eainitTbli 


aodeFlag 

10 $ 

r3, #initTbl 

#<einitTbl-initTbl) 

Strout 


;stabilisce <iual e' il aedo grafico selezionato 
;salta se e' stato selezionato il aodo RSCII 
indirizzo della stringa coaando 
; lunghezza della stringa 
; trasaette la stringa e teraina 


r3, fainitTbl jindirizzo della stringa coaando 

#(eainitTbl-ainitTbl) ; lunghezza della stringa 

Strout jtrasaette la stringa e teraina 


S, "fi“, ESC jtrasaette il nuovo interlinea da 8/72" 

ESC jcoaando di reset per la staapante 


2, ESC jcoaanda di staapare 6 linee per pollice 

ESC jcoaando di reset per la staapante 





I DRIVER DI STAMPA 


417 


SetGraphics 


Funzione: Attiva il modo grafico ddia stamparìte Epson (640 punti per linea). 

Chiamata da: PrintPrintBuffer 


Parametri: cardCount il numero di matrici grafiche noi significative (azzerate) contate 

dalla fine della riga verso sinistra 


Restituisce: r3 


sCount 

y 


l’indirizzo (memorizzato anche nei due byte a wsdgphTbl) 
della word in memoria contenente il numero di byte che 
devono essere trasmessi alia stampante per la linea 
corrente 
$FF 
0 


Distrugge: a 


Sinossi: Seleziona il modo grafico delia stampante e trasmette il numero di byte che 

deve ricevere e stampare in alta risoluzione. 


SetGraphics; 


LoadB 

r3H, #0 

jazzera il byte piu' significativo 

MoveB 

cardCount, r3L 

;Meraorizza cardCount nel byte «eno significativo 
;in questo nodo r3 contiene il nunero di «atrici 
;grafiche non significative a fine riga 

asl 

r3L 

moltiplica r3 per 8 in modo da ottenere 
jil numero di byte 

rol 

r3H 

occupati dalle cardCount matrici grafiche 

asl 

r3L 


rol 

r3H 


asl 

r3L 


rol 

sec 

r3H 
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Ida 

♦«CflRDSWIDEtS) 

; preleva il byte basso del numero di byte 
;che compongono la riga grafica 

sbc 

r3L 

;sottrae il byte basso del numero di byte 
;da non stampare 

sta 

wsdgphTbl+1 

jmemorizza il byte basso come secondo byte 
;nella stringa comando 

Ida 

#><CflRDSWIDE*8) 

jpreleva il byte alto del numero di byte 
;che compongono la riga grafica 

sbc 

r3H 

jsottrae il byte alto del numero di byte 
jda non stampare 

sta 

wsdgphTbl 

jmemorizza il byte alto come primo byte 
jnel la stringa comando 

LoadU 

r3, #wsdgphTbl 

jmemorizza in r3 l'indirizzo della stringa comando 

Ida 

#(ewsdgphTbl-wsdgphTbl) 

jlunghezza della stringa comando 

Jinp 

Strout 

jtrasmette la stringa comando alla stampante 

wsdgphTbl i 

.byte 2, 128, 4, ESC 

jNl, N2: byte alto e byte basso del numero di byte 
jche la stampante deve stampare in modo grafico 
j4, ESC: comando di attivazione 

jdel modo grafico 


eusdgphTbl: 




Funzione: Trasmette una matrice grafica stampabile attraverso la porta seriale. 

Chiamata da: PrintPrintBuffer 


Parametri: pmtBICard questo buffer deve contenere la matrice grafica già ruotata 

Restituisce: Niente 
Dishugge: a, x 

Sinossi: Quando una matrice grafica è stata ruotata in modo tale che i bit di ogni byte 

corrispondano ai punti verticali della testina di stampa, SendBuff invia i dati 
della matrice alla stampante attraverso il bus seriale. 


SendBuffI 


Idx 

10$: 

#0 

jinizializza il contatore 

txa 

pha 


jsalva il contatore 

Ida 

prntBlCard, x 

;preleva il byte da trasmettere 

jsr 

Ciout 

jtrasmette il byte 

pia 

tax 


; recupera il contatore 

inx 


;punta al nuovo byte 

cpx 

♦8 

jse non sono stati trasmessi tutti i byte 
;della matrice 

bne 

10$ 

jriprende il loop di trasmissione 

rts 
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Greturn 


Funzione: Trasmette alla stampante i caratteri LF (riga nuova) e CR (ritorno carrello). 

Chiamata da: PrintBuffer 
Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, e diverse variabili utilizzate da Ciout 

Sinossi: Trasmette alla stampante i caratteri LF (riga nuova) e CR (ritorno carrello). 


Greturn! 


Ida 

♦CR 

;ritorno carrello 

Jsr 

Ciout 

;lo trasmette 

Ida 

♦LF 

;riga successiva 

jsr 

Ciout 

;lo trasmette 

rts 
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FormFeed 


Funzione: 

Chiamata da: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Trasmette alla stampante il comando form feed che fa avanzare la carta fino 
al foglio SLKxessivo. 

PrintBuffer 

Nessuno 

Niente 

a, e diverse variabili utilizzate da Ciout 

Trasmette alla stampante il comando form feed che fa avanzare la carta fino 
al foglio successivo. 


ForinFeed! 

Ida 

jsr 

rts 


#FF 

Ciout 


;il comando Form feed 
jlo trasmette 
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Funzione: Ruota gli otto byte della matrice grafica puntata da r3. In questo modo il 

nuovo buffer da otto byte, pmtBICard, contiene la matrice grafica 
opportunamente riordinata per essere trasmessa alla testina della stampan¬ 
te. 

Chiamata da: PrintPrintBuffer 

Parametri: r3 indirizzo della matrice grafica in memoria 

Restituisce: prntBICard questo buffer contiene la matrice grafica ruotata 

Distrugge: a, x, y 

Sinossi: L’ennesimo byte memorizzato nel buffer pmtBICard è composto dai bit in 

posizione ennesima, prelevati da ognuno dei byte di cui è composta la 
matrice grafica originale puntata da r3. La matrice ruotata può quindi essere 
trasmessa alla stampante. 


Rotate: 

sei 


;disabilita gli interrupt in modo da diminuire 
;il tempo d'esecuzione della routine 

Idy 

#7 

;inizializza l'indice per scorrere la matrice 
^originale 

lei: 

Ida 

(r3), y 

jpreleva il byte dalla matrice grafica 

Idx 

#7 

jinizializza l'indice per la matrice stampabile 

20t; 

ror 

a 

;meraorizza in C il bit meno significativo 

ror 

prntBICard, x 

je lo fa entrare nel byte correntemente puntato 
jall'interno del buffer 

dex 


;bit successivo 

bpl 

20$ 

;se non e' l'ultimo, riprendi il loop 

dey 


,'byte successivo 

bpl 

10$ 

;se non e' l'ultimo, riprendi il loop 

eli 


iriabilita gli interrupt 

rts 


PRINTEND; 


;ultiiiia label nel driver per la stampante Epson FX-80 
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n file geosUtilities per i driver di stampa 


In questo file sono riportate le seguenti routine; 


OpenFile: 

CloseFile; 

OpenPrint: 

ClosePrint: 

Strout: 


apre la struttura Commodore del file 

chiude la struttura Commodore del file 

prepara la stampante all’ascolto sul bus seriale 

termina la comunicazione con la stampante sul bus seriale 

trasmette una stringa di byte sul bus seriale. 


Per ottenere maggiori informazioni sul protocollo di trasmissione del bus seriale del 
C-64 e le sue caratteristiche, consultare la guida operativa ufficiale. 
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OpenFile 


Parametri: 
Chiamata da: 
Distrugge: 
Sinossi: 


Nessuno 
PrintBuffer 
a, X, y 

Questa routine prepara la struttura del file per le comunicazioni attraverso il 
bus seriale. 


OperiFilei 


Ida 

♦PRINTflDDR 

;nuinero di dispositivo 

jsr 

Listen 

indirizza la stampante 

Ida 

#SECflDD|$F0 

jcarica l'indirizzo secondario per questa stampante 

jsr 

Second 

jlo trasmette 

jsr 

Unlsn 

jcomanda alla stampante di interrompere l'ascolto 
;sul bus 

rts 
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CloseFile 


Parametri: 
Chiamata da: 
Distrugge: 
Sinossi: 


Nessuno 
PrintBuffer 
a, X, y 

Disabilita la struttura del file precedentemente aperto per comunicare con la 
stampante. 


CloseFile: 


Ida 

♦PRINTflDDR 

; numero del dispositivo 

jsr 

Listen 

; indirizza la stampante 

Ida 

#SECflDD|$E0 

jcarica l'indirizzo secondario per questa stampante 

jsr 

Second 

;lo trasmette 

jsr 

Unlsn 

;comarida alla stampante di terminare l'ascolto 
jsul bus seriale 

rts 







42Ó 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


OpenPrint 

Parametri: Nessuno 

Chiamata da: PrintBuffer 

Distrugge: a, x, y 

Sinossi: Inizializza la stampante all’ascolto sul bus seriale. 


OpenPrinti 


Ida 

#PRINTflDOR 

jnumero del dispositivo 

jsr 

Listen 

; indirizza la stampante 

Ida 

#SEC:flOD|$60 

jcarica l'indirizzo secondario per questa stampante 

Jsr 

Second 

;lo trasmette 

rts 
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ClosePrìnt 

Parametri: Nessuno 

Chiamata da: PrintBuffer 

Distrugge: a, x, y 

Sinossi: Comanda alla stampante di cessare l’ascolto sul bus seriale. 


ClosePrint i 
jsr Unlsn 

rts 


; comanda alla stampante di cessare l'ascolto 
;sul bus seriale 
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Strout 


Parametri: r3 

a 


inizio della stringa da trasmettere (i dati devono essere disposti a 

partire dall’ultimo) 

numero di byte da trasmettere 


Chiamata da: InitPrinter 


Accede a: sCount 

Restituisce: sCount $FF 
y $00 


Distrugge: a 

Sinossi: Strout (string out) trasmette la stringa di caratteri puntata da r3 e composta 

da a byte. 


Strout : 

Sta 

sCount 

jsalva l'indice della tavola 

dee 

sCount 


1011 

Idy 

sCount 

; riprende l'indice 

Ida 

($r3).y 

jpreleva il byte 

Jsr 

Ciout 

;lo spedisce 

dee 

sCount 

jaggiorna l'indice 

bpl 

18$ 

;se la tavola non e' finita, procedi 
;con il prossimo carattere 

rts 
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Nella sua struttura generale, il driver Commodore presenta molte somiglianze con 
il driver Epson che abbiamo esaminato nel capitolo precedente, ma in questo caso la 
presenza di una testina da 7 punti rende più laborioso il processo di trasferimento dei 
dati grafici. Quando si hanno a disposizione stampanti a 7 punti verticali, il driver non 
può limitarsi a ruotare le matrici grafiche, ma deve gestire righe grafiche formate da 
8 linee di scansione trasmettendo sul bus seriale solo 7 linee alla volta. Deve quindi 
preoccuparsi di non perdere informazioni durante la stampa. In pratica, per ogni 
gruppo di 7 linee stampate ne rimane una in sospeso: quando il numero delle linee in 
sospeso arriva a 8, il driver, prima di procedere con la riga grafica successiva, stampa 
l’intera riga che si è venuta a creare durante il processo di trasferimento. A questo 
punto però è rimasta ancora una linea da stampare. Quindi il ciclo non riprende più 
dalla fase iniziale, nella quale non vi è nessuna linea in avanzo, ma dalla fase appena 
successiva. In pratica, quando si inizia la stampa di una pagina, il driver affronta una 
fase preliminare esterna al ciclo, che nel resto della pagina non verrà più ripercorsa. 
Il procedimento ciclico viene eseguito dalle routine TopRollBuffer e BotRollBuffer. Per 
la precisione, TopRollBuffer chiama RollaCard per prelevare il primo byte (quello più 
in aito) di una matrice grafica memorizzata nel buffer utente, spostando verso l'alto di 
una posizione i byte rimanenti. 

Ogni trasferimento di una riga grafica al bus seriale, provoca l'incremento di una 
unità tra le righe “in sospeso” conservate nel buffer utente. Nel driverii contatore delle 
linee in sospeso è breakCount. Queste linee vengono inserite nella riga grafica 
successiva, e trasmesse non appena PrintBuffer viene nuovamente chiamata. 
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Quando sono state stampate 7 linee di scansione, BotRollBuffer trasferisce le linee 
di scansione avanzate dal buffer utente nel buffer di stampa interno facendo 
opportunamente.salire la linea avanzata dall’ultima stampa, che deve poi diventare la 
prima della nuova riga grafica. Ovviamente queste linee, essendo le prime che devono 
essere stampate con la successiva chiamata di PrintBuffer, verranno disposte in alto 
nel buffer di stampa. Per meglio comprendere il procedimento di stampa, analizziamo 
un esempio pratico osservando le tavole riportate nelle pagine che seguono. In esse 
sono rappresentati sei stadi, i primi e gli ultimi aU’interno di un ciclo di nove stadi. 
I tre stadi centrali sono facilmente deducibili una volta che si è compreso il 
funzionamento dell’algoritmo di stampa. L’esempio descritto nelle tavole, per 
semplicità, assume che la pagina da stampare contenga soltanto una fila verticale di 
9 matrici grafiche. 

Quando l’applicazione inizia la stampa della pagina, entra nella fase 0, caratterizzata 
dall’assenza di linee in avanzo e quindi da breakCount = 0. L’applicazione memorizza 
nel buffer utente la prima matrice (che nel nostro esempio rappresenta l’intera riga 
grafica). Tramite TopRollBuffer, il driver trasferisce 8(8 = 8- breakCount) nel buffer 
di stampa, cioè l’intera matrice grafica. Subito dopo, 7 degli 8 byte vengono stampati, 
lasciando nel buffer di stampa un byte di avanzo. Dal momento che in questa fase 
preliminare non vi erano byte in avanzo nel buffer utente (breakCount = 0), 
BotRollBuffer non esegue alcuna operazione. 

L’applicazione riprende il controllo e memorizza nel buffer utente una nuova matrice 
che sul foglio dev’essere stampata appena sotto la precedente. breakCount ora vale 1, 
e si entra nella prima fase del ciclo. Tramite TopRollBuffer, il driver trasferisce 7 byte 
(8 - breakCount) dal buffer utente al buffer di stampa, facendo salite il byte in avanzo 
presente nel buffer di stampa al primo posto. In questo modo rimane un byte non 
trasferito nel buffer utente. Vengono stampati i primi 7 byte e nel buffer di stampa 
rimane, come sempre, un byte in avanzo. Vi sono ora due byte in avanzo: uno nel buffer 
utente e uno nel buffer di stampa. A questo punto BotRollBuffer trasferisce un byte (1 
= breakCount) dal buffer utente al buffer di stampa. Questo trasferimento fa in modo 
che il byte in avanzo presente nel buffer di stampa salga di una posizione. 

L’applicazione riceve nuovamente il controllo e memorizza una nuova matrice 
grafica nel buffer utente, entrando così nella seconda fase del ciclo caratterizzata da 
breakCount = 2. 

Il ciclo continua fino al termine della settima fase, quando i byte totali sono 8, e sono 
tutti contenuti nel buffer di stampa. Allora il driver stampa anche questo gruppo di 8 
byte, producendo nuovamente 1 byte in avanzo. breakCount viene aggiornato 
nuovamente con il valore 1 e il ciclo riprende dalla prima fase, e non più dalla fase 0. 

Questo è l’algoritmo di stampa impiegato dal driver per le stampanti Commodore 
compatibili a 7 punti. Com’è possibile rendersi conto, dal punto di vista dell’applica¬ 
zione il tipo di stampante impiegata, e quindi di driver, è completamente irrilevante. 
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Procedura di stampa a 7 bit 
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(Le fasi dalla 3 alla 5 non sono riportate per brevità) 


BUFFER UTENTE 


BUFFER DI STAMPA 


Matrice grafica 



Matrice grafica 


Fase 6 breakCount = 6 


2 byte trasferiti 


da TopRollBuffer 


6 byte trasferiti 


da BotRollBuffer 


Fase 7 breakCount = 7 



iStSSSSSiStSiSi^ 

SSSSSSSSSSSSi 

WtSSRKSXXXXJ' 

&»««»»« 

KWJOOOOOO»» 


}»»»»»« 

SMSfifissaasss 

wwww 


1 byte trasferito 


da TopRollBuffer 


7 byte trasferiti 


da BotRollBuffer 


7 byte alla 



lPS»!iK»Sn 

ìfoaaaaaa 

\r M9Wjnnn 

■ __jaa3ia 

\imnaan^ 

- 



7 byte alla 


stampante 


7 byte alla 


stampante 


Fase 1 breakCount = 1 


Matrice grafica 





IS9eSW999W«l 



7 byte trasferiti 


da TopRollBuffer 


1 byte trasferito 


da BotRollBuffer 


7 byte alla 
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11 driver di stampa per le stampanti 
Commodore compatibili 

Questo driver è stato Ideato per le stampanti: 

COMMODORE MPS-801, MPS-803, MPS-1000, 1525 
ERGO SYSTEMS HUSH 80CD 
GRIDATA OKIMATE 10 
SEIKOSHA SP-IOOOVC 

ed è stato sottoposto al test di verifica utilizzando le stampanti: 

COMMODORE MPS-801, MPS-1000 
ERGO SYSTEMS HUSH 80CD 
SEIKOSHA SP-IOOOVC. 

Ecco il listato del file sorgente utilizzato per questo driver di stampa. 

di - 

Costanti per la stampante 


LOWERCflSE 

= 7 

; comando per la stampante 

- 99 

CflRDSWIDE 

= 60 

larghezza in matrici grafiche Commodore 


CflRDSDEEP 

= 94 

jaltezza in matrici grafiche Commodore 


SECfiDD 

= LOWERCflSE 

jindi rizzo secondario 


CGPX 

= 8 

/■comando di attivazione del modo grafico 


ECGPX 

= 15 

;comando di disattivazione del modo grafico 


PRINTflDOR 

= 4 

;numero di dispositivo della stampante 


PRINTBflSE 

= $7900 

indirizzo al quale il driver dev'essere rilocato 

.include 

geosMacros 

jper questi file consultare l'appendice 
jmacro per l'flssembler della Berkeley 


.include 

geosConstants 

jcostanti 


.include 

geosMemorytIap 

locazioni e variabili nella RAM 


.include 

geosRoutines 

;jump table per le routine di GEOS 


.psect 

PRINTBflSE 

jindirizzo al quale allocare il file oggetto 

compilato 
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44 _ 

Jump table residente 


99 


InitForPrinti 

rts 



nop 



nop 


StartPrint; 

jmp 

r-StartPrint 

PrintBufferi 

jmp 

r-PrintBuffer 

StopPrint 1 

jmp 

r-StopPrint 

GetDiraensions: 

jmp 

r-GetDimensions 

PrintflSCII 1 

jmp 

r-PrintflSCII 

StartlìSCIIì 

jmp 

r-StartflSCII 

SetNLQ: 

rts 



nop 



nop 



jpriuia routine a PRINTBfiSE 

jper questa stampante la routine 

jnon deve compiere alcuna operazione 

jseconda routine a PRlNTBflSE + 3 

; terza routine a PRINTBFISE + 6 

;quarta routine a PRlNTBflSE + 9 

; quinta routine a PRINTBFISE + 12 

jsesta routine a PRlNTBflSE + 15 

jsettima routine a PRlNTBflSE + 18 

; ottava routine a PRlNTBflSE + 21 

;non disponibile per questo tipo di stampante 


44- 

Variabili in RAM e utility 


printerName; 

prntBlCard; 
breakCount : 


99 


.byte "Comm, Compat,",0 


.byte 0; 0, 0; 0, 0; 0, 0; 0 
.byte 0 


jnome della stampante come dovrebbe apparire 
;nel menu di selezione della stampante 
,'matrice grafica stampabile 
;contatore delle linee rimaste 



IL DRIVER DI STAMPA COMMODORE 


435 


sCount I 

cardCounti 
iriodeFlagi 

.include 


.byte 8 


.byte 0 
.byte 0 


;contatore delle linee all'interno della matrice 
jgrafica corrente 

icontatore delle matrici grafiche azzerate a fine riga 
)f00=stampa grafica, ÌFF=stampa ASCII 


geosUtilities jfile contenente le routine di basso livello 

;di comunicazione con la stampante. Questo file e' 
;riportato alla fine del capitolo precedente 
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Le routine direttamente accessibili 
dairapplicazione 


StartPrint 


Funzione: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Prepara la stampante all’inizio di ogni pagina del documento. 

Nessuno 

X 7^= 0 codice dell’eventuale errore 
Tutti i registri 

Questa routine prepara il bus seriale e la stampante per procedere alla 
stampa di una pagina. La stampante viene opportunamente configurata e il 
contatore breakCount viene azzerato. 


r-StartPrint ; 


Ida 

#0 

; imposta il modo grafico 

sta 

modaFlag 


Startlni 

Ida 

♦PRINTflDDR 

jattiva il dispositivo 4 

jsr 

SetDevice 


jsr 

InitForlO 

;attiva il Kernel del C-64, lo spazio di I/O 

Ida 

#0 

;e disabilita gli interrupt 

sta 

breakCount 

;inizializza il contatore delle linee rimaste 

sta 

*90 

jimposta l'indicatore d'errore a nessun errore 

jsr 

OpenFile 

japre il file fittizio di comunicazione con 

Ida 

$90 

jla stampante se si e' verificato un errore con 

bne 

20$ 

;il canale di output^ esegue la routine 
;di gestione degli errori 
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Jsr 

Delay 

jsr 

DoneUithIO 

Idx 

#0 

rts 


28$; 


pha 



jsr 

CloseFile 

jsr 

OoneUithIO 

pia 


tax 


rts 


Delay: 


Idx 

#0 

10$; 


Idy 

#0 

20$; 


dey 


bne 

20$ 

dex 


bne 

10$ 

rts 



jattende per eliminare eventuali problemi 
jdi temporizzazione 

iripristina lo stato precedente alla chiamata 
;di InitForlO 
jnessun errore 


;salva temporaneamente l'eventuale codice d'errore 
ifait 0 impostato a 1: timeout, scrittura 
;bit 7 impostato a li device non presente 
jchiude il file 

jripristina lo stato precedente alla chiamata 
jdi InitForlO 

; recupera il codice d'errore 
;e lo trasferisce in x 
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Funzione: Trasmette alla stampante i dati grafici contenuti nel buffer da 640 byte (80 

matrici grafiche) creato dall’applicazione. 

Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) 

ri indirizzo del buffer di stampa da 1920 byte che l’applicazione deve 
mettere a disposizione della routine PrintBuffer 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per le 
stampanti a 7 bit utilizzano questo buffer per non perdere le linee 
di scansione accumulate a ogni chiamata di PrintBuffer 

Restituisce: rO, ri inalterati 

Distrugge: Tutti i registri 

Sinossi: PrintBuffer, come è già stato spiegato, è la routine di livello più alto in grado 

di trasferire il contenuto grafico del buffer da 640 byte dalla memoria del C-64 
alla stampante attraverso la porta seriale. 


r-PrintBufferi 


Ida 

♦PRINTflDDR 


jsr 

SetOevice 

jattiva il dispositivo associato 

jsr 

InitForlO 

jattiva il Kernel del C-64', lo spazio di I/O 
je disabilita gli interrupt 

jsr 

OpenPrint 

japre il canale di comunicazione con la stampante 

jsr 

LPriritBuf fer 

; trasmette la riga grafica alta 8 bit memorizzata 
;nel buffer utente 

jsr 

ClosePrint 

jchiude il canale di comunicazione con la stampante 

jsr 

DoneWithIO 

jripristina lo stato precedente alla chiamata 

rt£ 


;di InitForlO 
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I-PriniBufferi 


Jsr 

TopRollBuffar 

jtrasfarisca (8 - braakCount) linae dal buffer 
jutanta al buffar di stampa 

MowaW 

ri, r3 


jsr 

PrintPrintBuffer 

)stampa il contenuto del buffer interno 

jsr 

BotRollBuffer 

Jtrasfarisca braakCount linee non stampata 
jdal buffer utente al buffer di stampa 

Ida 

braakCount 

jcontrolla se la linee rimaste sono 8 

cmp 

♦7 


bna 

5$ 

jse non sono 8, salta 

MovaW 

Osi 

jpunta al buffer di stampa 

jsr 

PrintPrintBuffar 

jstampa la riga grafica che si e' creata con 
jle successive linee "in sospeso" e rigenera 
juna linea in sospeso 

Ida 

#0 

jazzera il contatore delle linee rimaste 

sta 

braakCount 


ine 

braakCount 

; incrementa il contatore di linee in sospeso, 
jin modo che la fase successiva non sia 


;la condiziona iniziala (braakCount - 0 ), ma 
;iualla saguanta (braakCount = 1) 
rts 
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StopPrint 


Funzione: Si esegue al termine della stampa di ogni pagina, per cancellare il buffer di 

stampa e ordinare alla stampante di fare avanzare la carta fino al foglio 
successivo. StopPrint viene eseguita anche quando termina il documento. 

Parametri: rO indirizzo del buffer da 640 byte (80 matrici grafiche) 

r1 indirizzo del buffer di stampa da 1920 byte che l’applicazione deve 
mettere a disposizione del driver per suo uso interno 

Nota: l’indirizzo di quest’ultimo buffer non deve cambiare fra una 
chiamata a PrintBuffer e la successiva. I driver di stampa per le 
stampanti a 7 bit utilizzano questo buffer per conservarvi le linee 
di scansione perse a ogni chiamata di PrintBuffer 


Restituisce: rO, ri inalterati 


Distrugge: Tutti i registri 

Sinossi: StopPrint dev’essere chiamata quando si giunge al termine di una pagina o 

dell’intero documento. Manda in esecuzione SetDevice, InitForlO, mette in 
ascolto la stampante, e se la testina è a 7 bit stampa eventuali linee rimaste 
nel buffer di stampa. Quindi cancella il buffer di stampa, effettua 
l’avanzamento del foglio all’inizio della nuova pagina, comanda alla 
stampante di cessare l’ascolto sul bus seriale, chiude il file Commodore di 
output ed esegue la routine DoneWithlO. 


r.StopPrint i 


Ida 

♦PRINTflDDR 


jsr 

SetDevice 

;attiva il dispositivo associato 

jsr 

InitForlO 

)attiva il Kernel del C-64, lo spazio di I/O 
;e disabilita gli interrupt 

jsr 

OpenPrint 

;apre il canale di comunicazione con la stampante 

bit 

imodeFlag 

;se la stampa e' RSCII 

blTii 

10$ 

jeffettua lo svuotamento del buffer 

PushW 

r0 

;salva gli indirizzi dei buffer 
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PushW 

ri 

MoveW 

r0, ri 

LoadU 

r0,«40 

jsr 

ClearRam 

PopW 

ri 

PopW 

r0 

jsr 

$; 

I-PrintBuffer 

Jsr 

FormFeed 

jsr 

ClosePrint 

jsr 

CloseFile 

jsr 

rts 

DoneUithlO 


;carica 1'indirizzo del buffer da cancellare 
ilunghezza in byte del buffer da cancellare 
;lo cancella 

{recupera gli indirizzi dei buffer 

{Stampa le linee accumulate nel buffer 

{fa avanzare la carta fino all'inizio 
{del nuovo foglio 
{Chiude il canale di stampa 
{Chiude il file di output 

{ripristina lo stato precedente alla chiamata di 
{InitForlO 





Funzione: Restituisce le dimensioni (in matrici grafiche) del disegno che la stampante 

è in grado di riprodurre sul foglio. 

Parametri: Nessuno 

Restituisce: x larghezza in matrici grafiche della linea che la stampante è in grado di 
stampare 

y altezza in matrici grafiche dello spazio lungo il foglio entro il quale la 
stampante è in grado di stampare 

Distrugge: Niente 

Sinossi: GetDimensions restituisce il numero di matrici grafiche in larghezza e in 

altezza che la stampante è in grado di stampare in un rettangolo di 8 x 10,5 
pollici. Questo rettangolo è compreso interamente nel foglio di stampa, il 
quale misura di solito 8,5 x 11 pollici. 


r-GetDimensionsi 

Idx 

Idy 

Ida 

rts 


♦CflRDSWIDE 

#CflRDSDEEP 

#0 


jnijKiero di matrici grafiche orizzontali 
jnumero di matrici grafiche verticali 
jimpostato a 0 per i driver grafici 







StartASCII 

Funzione: 

Inizializza la stampante Commodore in modo che tratti i dati trasmessi come 
codici ASCII. 

Parametri: 

Nessuno 

Restituisce: 

Niente 

Distrugge: 

Tutti i registri 

Sinossi: 

Imposta il flag modeFlag per indicare la selezione del modo ASCII di stampa. 
Chiama Startln per procedere all’inizializzazione. Questa routine dev’essere 
chiamata all’inizio di ogni pagina. 


r-StartflSCII ! 
LoadB 
jmp 


modeFlag, #IFF 
Startln 


; imposta il modo ASCII di stampa 

;utilizza una parte di StartPrint per procedere 

;alla preparazione della stampante 
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PrintASCII 


Funzione: 

Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


Trasmette alla stampante una stringa ASCII a terminazione nulla. 

rO puntatore alla stringa ASCII 

Niente 

Tutti i registri 

Trasmette la stringa ASCII a terminazione nulla puntata da rO. La stringa può 
contenere caratteri CR per la separazione delle righe. La routine, quando 
incontra il carattere CR, trasmette di seguito anche il carattere LF. 


r_PriritfiSCIl! 


Ida 

♦PRINTflDDR 


jsr 

SetDevice 

;attiva il dispositivo associato 

jsr 

InitForlO 

,'attiva il Kernel del C-64, lo spazio di I/O 
je disabilita gli interrupt 

jsr 

101: 

OpenPrint 

japre il canale di comunicazione con la stampante 

Idy 

#0 

;azzera l'indice per scorrere la stringa ASCII 

Ida 

(r0), y 

jpreleva il carattere 

bei 

30* 

)se ha raggiunto la fine della stringa, conclude 
;la sua esecuzione 

crup 

#65 

tcontrolla se il carattere e' alfanumerico 

bcc 

12* 

jsalta la conversione se e' minore di 'A' 

cmp 

#123 


bcs 

12* 

jsalta la conversione se e' maggiore di 'z' 

eor 

12t; 

#*20 

jconverte le maiuscole in minuscole e viceversa 
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IncW r0 

jmp 101 

3011 

jsr ClosePrint 

jsr DoneWithIO 

rts 


jpuntà al carattere successivo 
; ripete il loop 

ichiude il canale con la stampante 
; ripristina lo stato precedente alla chiamata 
jdi InitForlO 
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Le routine interne del driver 


PrintPrintBuffer 


Funzione: Trasmette il buffer di stampa puntato da r3. 

Chiamato da: PrintBuffer 

Parametri: r3 indirizzo del buffer in memoria 

Restituisce: Niente 

Distrugge: a, x, y, rO - r15 

Sinossi: Tramite TestBuffer controlla se il buffer è vuoto, prima di procedere alla 

stampa della riga grafica. Se il buffer non è vuoto, la routine, per ogni matrice 
grafica prelevata dal buffer, ruota i byte e li trasmette alla stampante. 
TestBuffer inoltre restituisce in cardCount il numero di matrici grafiche 
azzerate a partire dal lato destro della riga grafica. PrintPrintBuffer, valutando 
opportunamente cardCount, è in grado di ottimizzare il tempo di stampa 
trasmettendo esclusivamente le matrici grafiche significative della riga. 


PintPrintBufferi 

PushW 

r3 

jsalva il puntatore al buffer 

jsr 

TestBuffer 

;coritrolla se il buffer e' completamente azzerato 
;e aggiorna cardCount 

bcs 

5$ 

;se il buffer contiene dati, inizia 
jil trasferimento 

PopW 

r3 

;svuota lo stack 

jsr 

SetGraphics 

; attiva il modo grafico 

jmp 

20t 

stermina la stampa della riga 

5$i 

jsr 

SetGraphics 

jattiva il modo grafico per la riga corrente 
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PopW r3 ; recupera il puntatore alla matrice grafica 

;corrente 

Ida #CflRDSWlDE jcarica la massima larghezza della riga grafica 


sec 

sbc cardCount 


lei: 


txa 


pha 


Jsr 

Rotate 

Jsr 

SendBuff 

Rdd'JU 

#8, r3 

pia 


tax 


dex 


bne 

10$ 


20$ I 

jsr Greturn 

jsr UnSetGraphics 

rts 


jsottrae il numero di mappe grafiche nulle 
ja partire dal lato destro della riga grafica 
jottenendo l'esatto numero di matrici grafiche 
;significative 

; salva x 

jruota la matrice grafica puntata da r3 
jtrasmette la matrice grafica ruotata 
;aggiorna r3 in modo che punti alla matrice 
jgrafica successiva 
jrecupera x 

;se non ha trasmesso tutte le matrici grafiche, 
; ripete l'operazione con la successiva 

^effettua il ritorno del carrello a nuova riga 
;disabilita il modo grafico 
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TopRollBuffer 


Funzione: Trasferisce dal buffer utente al buffer di stampa il numero di linee indicato 

da (8 - breakCount). 

Chiamata da: PrintBuffer 


Parametri: rO puntatore al buffer utente 

r1 puntatore al buffer di stampa 

Restituisce: Niente 


Distrugge: a, x 

Sinossi: TopRollBuffer trasferisce tante linee quante ne indica (8 - breakCount) dal 

buffer utente al buffer di stampa. Sono le linee appena memorizzate 
dairapplicazione. Se è presente un residuo di linee prodotto dalla stampa 
delle righe precedenti, la routine provvede a posizionare nel buffer di stampa 
le nuove linee in modo che non cancellino quelle rimaste, già trasferite da 
BotRollBuffer. 


TopRollBuffer; 

PushW 

r0 

;salva 1 puntatori ai buffer 

PushW 

ri 


Idx 

#CflRDSWIDE-l 

;carica il numero di matrici grafiche diminuito 
;di 1 

10$; 

ld<j 

breakCount 

jpreleva il contatore delle linee rimaste 

Ida 

topBreakTab, y 

;preleva il numero di linee da trasferire 

jsr 

RollaCard 

trasferisce la matrice grafica 

dex 


jse le matrici grafiche non sono ancora finite 

bpl 

10$ 

jriprende il loop per trasferire la matrice 
jsuccessiva 

PopW 

ri 

;ripristina i puntatori 

PopW 

r0 


rts 

lopBreakTab; 

.byte 

8, 7, S, 5, 4, 3, 2, 1 
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BotRollBuffer 


Funzione: Trasferisce nel buffer di stampa le breakCount linee rimaste. 

Chiamata da: PrintBuffer 

Parametri: rO puntatore al buffer utente 

r1 puntatore al buffer di stampa 

Restituisce: Niente 

Distrugge: a, x 

Sinossi: BotRollBuffer trasferisce le linee rimaste nel buffer di stampa, collocandoie 

nei primi posti, in modo che TopRoilBuffer possa poi completare il buffer di 
stampa trasferendovi le linee della riga trasmessa dall’applicazione. 


BotRollBufferi 

Ida 

breakCount 

;se breakCount = 0, la routine non deve eseguire 

bei 

20$ 

; alcuna operazione 

jalcuni driver per stampanti a 7 punti 
;non contengono questo controllo, e producono 
;un difetto nella prima riga di stampa 

PushW 

r0 

;salva i puntatori ai buffer 

PushW 

ri 


Idx 

#CflRDSWIDE-l 

;carica il numero delle matrici grafiche diminuito 
;di 1 

10$; 

Ida 

breakCount 

jcarica il contatore delle linee in sospeso 
jnon ancora trasferite 

jsr 

RollaCard 

jtrasferisce il numero di linee della matrice 
/■grafica indicato nel registro a 

dex 

bpl 

10$ 

)se le matrici grafiche non sono finite, 

; riprendi il loop 

PopW 

ri 

^ripristino i puntatori 

PopW 

r0 


20$: 

rts 
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RollaCard 


Funzione: Trasferisce dal buffer utente al buffer di stampa tanti byte quanti ne sono 

indicati nel registro a. Ogni byte appartiene a una diversa linea di stampa. 

Chiamata da: TopRollBuffer, BotRollBuffer 

Parametri: a numero di linee da trasferire 

Restituisce: rO rO + 8 

r1 = r1 + 8 
r3L = 0 


Distrugge: a 

Sinossi: Trasferisce dal buffer utente al buffer di stampa tanti byte quanti ne sono 

indicati nel registro a. Ogni byte appartiene a una diversa linea di stampa. 


RollaCardi 

sta 

r3L 

; memorizza il numero di loop da eseguire 
)(cioe' il numero di linee da trasferire) 

10$; 

jsr 

RollSbytesOut 

jtrasferisce nel buffer di stampa un byte 
jdella matrice grafica memorizzata 

jsr 

RollSbytesIn 

;nel buffer utente 

dee 

r3L 

;se non sono stati trasferiti tutti i byte 
;della matrice grafica corrente 

bne 

10$ 

jriprendi il loop 

RddUU 

#8, r0 

;aggiorna il puntatore del buffer utente 
jalla nuova matrice grafica 

RddVU 

CO 

jaggiorna il puntatore del buffer di stampa 
jalla nuova matrice grafica 

rts 







Funzione: Controlla se il buffer contiene dati grafici da stampare. La routine restituisce 

in cardCount il numero di matrici grafiche azzerate che incontra lungo la riga 
grafica scorrendola da destra a sinistra. Questa informazione serve a evitare 
che PrintPrintBuffer perda tempo nella trasmissione di matrici grafiche non 
significative, che servono solo per completare la riga. 

Chiamata da: PrintPrintBuffer 

Parametri: r3 puntatore all’inizio del buffer da controllare 

Restituisce: c impostato a 1 se il buffer contiene dati, impostato a 0 se il buffer è vuoto 

Distrugge: a, x, r3 

Sinossi: Controlla che i byte contenuti nel buffer non siano tutti a 0. Il controllo inizia 

dal lato destro della riga grafica e procede verso sinistra, matrice per matrice. 
Durante la scansione, la routine mantiene aggiornato il contatore countCard. 
Quando incontra un byte diverso da 0, la routine cessa la scansione, imposta 
a 1 il carry ed esce. ^ invece la routine non incontra alcun byte diverso da 
zero, esce impostando il carry a 0. Per questo driver, TestBuffer controlla 
solo matrici da 7 byte. 


TestBuffer; 


LoedB 

cardCount, #8 

jazzera il contatore delle matrici grafiche azzerate 

Ida 

#6 

;assume che la testina sia da 7 punti 

sta 

sCount 

jaggiorna il contatore di linee di scansione 
jall'interno della matrice grafica 

fìddVU 

#((CflRDSWIDE-l)*8), r3 

jaggiorna r3 in modo che punti al primo byte 
jdell'ultima matrice grafica lungo la riga 

Idx 

10tl 

♦CflRDSWIDE 

jaggiorna x con il numero di matrici presenti 
jin una riga grafica 

Idy 

sCount 

jpreleva il contatore di linee aH'interno 
jdella matrice grafica corrente 
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20$: 

Ida 

<r3), y 

;controlla un byte 

bne 

30$ 

ìse e' uguale a 0 termina l'esecuzione della routine 

dey 


jpunta al byte precedente nella matrice grafica 

bpl 

20$ 

:se non ha terminato la scansione della matrice 
;grafica corrente, controlla il byte precedente 

SubUU 

#8, r3 

raggiorna r3 in modo che punti all'inizio 
;della matrice grafica precedente 

ine 

cardCount 

;incrementa il contatore di matrici grafiche 
jazzerate 

dax 


;se non sono state controllate tutte le matrici 
;grafiche della riga 

bpl 

10$ 

jva a verificare la precedente 

eie 


;se con questa istruzione la routine conclude la sua 
;esecuzione, significa che il buffer e' vuoto 

rts 

30$: 

sec 


; imposta il carry a 1 per indicare che il buffer 
;non e' vuoto 

rts 
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Roll8bytesln 


Funzione: Trasla di una posizione verso l’alto ì byte della matrice grafica corrente 

memorizzata nel buffer di stampa e memorizza nell’ultima posizione il valore 
passato in a. 

Chiamata da: RollaCard 


Parametri: a byte da aggiungere nell’ultima posizione aH’intemo della matrice grafica 

r1 puntatore alia matrice grafica da traslare verso l’alto di una posizione 


Restituisce: Niente 


Distrugge: a, y 

Sinossi: RolISbytesIn trasla di una posizione verso l’alto i byte della matrice grafica 

memorizzata nel buffer di stampa. L’ultima posizione che si crea viene 
riempita con il byte passato alla routine nel registro a. Tale byte dev’essere 
preparato da RolISbytesOut che di solito viene chiamata immediatamente 
prima di RolISbytesIn. 


Roll8bytesIn: 

pha 


jsalva il byte da aggiungere 

Idy 

«0 

;inizializza l'indice per scorrere i byte 
;della matrice 

101; 

iny 


jpunta alla successiva posizione verso il basso 
;(il primo byte viene perso) 

Ida 

(ri), y 

jcarica dalla matrice il byte della linea 

day 


;punta alla posizione precedente 

sta 

(ri), y 

;e vi memorizza il byte 

iny 


jpunta alla successiva linea verso il basso 

cpy 

#7 

jse non siamo all'ultimo byte della matrice 

bmi 

10$ 

; riprende il loop 

pia 


jriprende il byte da aggiungere 

sta 

(ri), y 

;e lo memorizza nell'ultima posizione 
jdella matrice grafica 


rts 






Funzione: Restituisce in a il primo byte della matrice grafica corrente memorizzata nel 

buffer utente e trasla di una posizione verso l’alto i restanti byte. 

Chiamata da: RollaCard 

Parametri: rO puntatore alla matrice grafica da traslare verso l’alto di una posizione 

Restituisce: a primo byte della matrice grafica corrente 

Distrugge: a, y 

Sinossi: RolISbytesOut trasla di una posizione verso l’alto i byte della matrice grafica 

corrente memorizzata nel buffer utente. Viene utilizzata per svuotare il buffer 
utente. Con la traslazione viene restituito il primo byte che in seguito viene 
passato a RolISbytesIn. 


RolISbytesOut i 
Idy *0 


Ida 

pha 

10 $; 

iny 

Ida 

dey 

sta 

iny 

cpy 

bmi 

pia 

rts 


(r0), y 

Cr0); y 

(r0), y 

#7 

101 


jinizializza l'indice per scorrere i byte 
;della matrice 

;carica dalla matrice il byte piu' alto 
;lo salva 

;purita alla successiva posizione verso il basso 

jcarica il byte della linea dalla matrice 

;punta alla posizione precedente 

je vi memorizza il byte 

jpunta alla successiva linea verso il basso 

ise non siamo all'ultimo byte della matrice 

(■riprende il loop 

; riprende il byte da passare a RolISbytesIn 
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Le routine specifiche Commodore 


SetGraphics 

UnSetGraphics 


Funzione: 

Parametri: 

Restituisce: 

Distrugge: 


SetGraphics attiva il modo grafico della stampante. 
UnSetGraphics disattiva il modo grafico. 

Nessuno 

Niente 

a, le variabili utilizzate da Ciout 


SetGraphics: 

Ida 

#CGPX 

icoKiando per abilitare il 

modo grafico 

jsr 

Ciout 

trasmette il comando 


rts 

UnSetGraphics: 

Ida 

#ECGPX 

; comando per disabilitare 

il modo grafico 

Jsr 

Ciout 

; trasmette il comando 


rts 
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Funzione: Trasmette una matrice grafica stampabile attraverso la porta seriale. 

Chiamata da: PrintPrintBuffer 


Parametri: pmtBICard questo buffer deve contenere la matrice grafica già ruotata 

Restituisce: Niente 
Distrugge: a, x 

Sinossi: Quando una matrice grafica è stata ruotata in modo che i bit di ogni byte 

corrispondano ai punti verticali della testina di stampa, SendBuff invia i dati 
della matrice alla stampante attraverso il bus seriale. 


SendBuff i 

Idx 

♦0 

jinizializza il contatore 

10$: 

txa 


;salva il contatore 

pha 

Ida 

prntBlCard, x 

;preleva il byte da trasmettere 

ora 

#180 

; imposta a 1 il bit 7 che non viene stampato 

jsr 

Ciout 

jtrasmette il byte 

pia 


jrecupera il contatore 

tax 

inx 


;punta al nuovo byte 

cpx 

#8 

;se non sono stati trasmessi tutti i byte 

bne 

10$ 

;della matrice 

; riprende il loop di trasmissione 

rts 
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Greturn 


Funzione: Trasmette alla stampante il carattere CR (ritorno carrello). 

Chiamata da: PrintBuffer 

Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, e diverse variabili utilizzate da Ciout 

Sinossi: Greturn trasmette alla stampante il carattere CR (ritorno carrello). 


Greturn: 

Ida 

Jsr 

ris 


#CR 

Ciout 


;coffiando di ritorno carrello 
;lo trasmette 
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Funzione: Trasmette alla stampante il comando form feed che fa avanzare la carta fino 

al foglio successivo. 

Chiamata da: PrintBuffer 


Parametri: Nessuno 

Restituisce: Niente 

Distrugge: a, e diverse variabili utilizzate da Ciout 

Sinossi: Trasmette alla stampante il comando form feed che fa avanzare la carta fino 

al foglio successivo. 


ForitiFeed; 

Ida 

Jsr 

rts 


#FF 

Ciout 


;il comando form feed 
;lo trasmette 
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Rotate 


Funzione: Ruota gli otto byte della matrice grafica puntata da r3. In questo modo il 

nuovo buffer da otto byte, prntBICard, contiene la matrice grafica 
opportunamente riordinata per essere trasmessa alla stampante. 

Chiamata da: PrintPrintBuffer 


Parametri: 

Restituisce: 

Distrugge: 

Sinossi: 


r3 indirizzo della matrice grafica in memoria 

prntBICard questo buffer contiene la matrice grafica ruotata 
a, X, y 

L’ennesimo byte memorizzato nel buffer prntBICard è composto da tutti gli 
ennesimi bit dei byte contenuti nella matrice grafica originale puntata da r3. 
La matrice ruotata può quindi essere trasmessa alla stampante. 


Rotate; 

sei 


jdisabilita gli interrupt, diminuendo cosi' 

)il tempo di esecuzione della routine 


#7 

;iniziali 2 za l'indice per scorrere la matrice 
;originale 

m-. 

Ida 

<r3), y 

jpreleva il byte dalla matrice grafica 

Idx 

#7 

jinizializza l'indice per la matrice stampabile 

20$; 

ror 

a 

jmeraorizza in C il bit meno significativo 

ror 

prntBICard, x 

je lo fa entrare nel byte correntemente puntato 
;aH ' interno del buffer 

dex 


jbit successivo 

bpl 

20$ 

;se non e' l'ultimo riprende il loop 

dey 


;byte successivo 

bpl 

10$ 

)se non e' l'ultimo riprende il loop 

eli 


; riabilita gli interrupt 

rts 

PRINTEND; 


jultima label nel driver per le stampanti 
jcompatibili Commodore 







LA CONFIGURAZIONE 
DI SISTEMA 


La procedura di Warm Start 

Quando si chiama la routine Firstlnit, viene mandata in esecuzione la cosiddetta 
“Warm Start” (partenza a caldo). È una procedura che riconfigura il sistema a uno stato 
di default, e dal momento che le applicazioni (per loro natura) devono operare in un 
ambiente perfettamente noto, è indispensabile che venga applicata. Qualsiasi 
applicazione produce inevitabilmente alcune alterazioni nella configurazione di 
default, che a priori non sono prevedibili. Per questo, la “Warm Start” deve di nuovo 
inizializzare tutte le variabili e i buffer di sistema cosicché l'ambiente operativo per la 
nuova applicazione sia perfettamente determinato. Il nome “Warm Start” indica che si 
tratta di ima procedura eseguibile solo a sistema già installato e attivato. È comunque 
parte della routine “ColdStart” che GEOS esegue al momento deU’installazione. 

Il listato che segue riporta le informazioni fondamentali sulla configurazione di 
default. È una raccolta delle operazioni più importanti che vengono eseguite durante 
la procedura di “Warm Start”. 

I compiti della routine Firstlnit non devono essere confusi con quelli della routine 
StartAppl. Firstlnit infatti riporta il sistema alla condizione in cui si trova quando è 
appena stato installato: tutte le variabili riaggiornate, i buffer e i vettori gestiti dal 
Kernel. Se per esempio lo schermo ha dei colori diversi da quelli di default, il mouse 
ha parametri di spostamento alterati e sono previsti due drive, quando si esegue la 
routine Firstlnit tutte queste modifiche vengono eliminate. StartAppl, invece, non 
ripristina tutte le variabili che costituiscono la configurazione corrente del sistema, ma 
riporta allo stato di default soltanto quelle strettamente necessarie perché l’appliceizio- 
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ne possa iniziare la propria esecuzione in un ambiente “pulito”. Oltre a questa 
operazione di parziale pulizia, StartAppl prepara i dati da trasferire all’applicazione, e 
la manda in esecuzione. Le variabile aggiornate anche da StartAppl sono evidenziate, 
nella tavola di “Warm Start" che segue, con le lettere “(SA)” all’inizio del commento. 


Numero Valore Indirizzo Commento 
di byte 


cld 

byte #$30 


CPU-DflTfl 

j<SR) cancella il modo decimale della CPU 
;(SR) seleziona tutta la RRM disponibile 
;per il C-64 

$0R0@ 0 


OS-VflRS 

;azzera l'area RRtI per le variabili 
;GE0S globali e locali 

;Configura le variabili hardware del C-64. Imposta il banco di memoria visto 
;dal processore VIC e tutte le variabili del processore 6526 CIfl con i valori 
;appropriati per l'ambiente GEOS 

byte #$2F 

byte #136 


CPU-DDR 

CPU-DRTfl 

;(SR) aggiorna il registro direzione dati 
jdel 6510 

; imposta provvisoriamente la mappa 


;della menioria ;in modo che siano attivati 
;lo spazio di I/O e il Kernel del C-64 


jinizializza i valori di scansione della tastiera a nessun tasto premuto 


byte 

0 

cialbase 

-F 

$03 

j(Sfl) azzera 

il 

registro b 

di direzione 






;dati del CIfi 

1 1 



byte 

0 

cialbase 

+ 

$0F 

j(SR) azzera 

il 

registro b 

di controllo 






;del CIR 1 




byte 

0 

cia2base 

-I- 

$0F 

;(SR) azzera 

il 

registro b 

di controllo 






;del CIR 2 




jse NTSC 

utilizza $00, 

se PRL utilizza 

$80 





byte 

$@0/$80 

cialbase 

+ 

$0E 

)(Sfl) azzera 

il 

registro a 

di controllo 






jdel CIfl 1 e 

imposta il bit 

50/60 Hz 

byte 

$00/$80 

cia2base 

-F 

$0E 

j(Sfl) azzera 

il 

registro a 

di controllo 






;del CIfl 2 e 

imposta il bit 

50/60 Hz 
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Numero Valore Indirizzo Commento 
di byte 


byte 

cia2base | 



#$30|#t04 1 



GRBflNK2 

ciaZbase 


byte 

#$3F 

cia2base 

+ 

m 

byte 

#t7F 

cia2base 

+ 

f0D 




vicBase 

byte 

$00,$00 

mob0xpos,mob0ypos 

byte 

$00,$00 

moblxpos,moblypos 

byte 

$00,$00 

mob2xpos,mob2ypos 

byte 

$00,$00 

mob3xpos,mob3ypos 

byte 

$00,$00 

mob4xpos,mob4ypos 

byte 

$00,$00 

mob5xpos,mob5ypos 

byte 

$00,$00 

mob6xpos,mob6ypos 

byte 

$00,$00 

mob7xpos,mob7ypos 

byte 

$00 

msbxpos 


byte 

st-den|st-25 

row|st-bmm|3 

grcntrll 

byte 

251 

rasreg 

byte 

SKIPFLflC 

Ipxpos 

byte 

SKIPFLflC 

Ipypos 

byte 

byte 

byte 

,'00000601 

st-40col 

;'00000000 

mobenble 

grcntrl2 

moby2 


;(SFI) imposta alcuni bit di gestione 
;del bus seriale e seleziona il banco 
;di memoria visto dal processore UIC 

j(Sfl) imposta il registro direzione dati 
idei CIfl 2 

azzera il registro di controllo 
jdel CIfl 2 

j<Sfl) inizializza il processore UIC 
;(Sfl) posizioni degli sprite 

;(Sfl) posizione sprite 8 
j(Sfl) posizione sprite 1 
;(Sfl) posizione sprite 2 
;<Sfl) posizione sprite 3 
;(Sfl) posizione sprite 4 
;(Sfl) posizione sprite 5 
;(Sfl) posizione sprite S 
;(Sfl) posizione sprite 7 

;(Sfl) bit piu' significativo per 
;la coordinata x di ogni sprite 


j<Sfl) registro di controllo della grafica 

;(Sfl) registro raster di schermo (impostato 
;per interrupt al fondo dello schermo) 

)(Sfl) coordinata x della penna ottica 
;(flag a sola lettura) 

;(Sfl) coordinata y della penna ottica 
;(flag a sola lettura) 
j(Sfl) sprite attivi (solo il mouse) 
j(Sfl) registro di controllo della grafica 
j(Sfl) espansione y degli sprite«disabilitata 
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Numero Valore Indirizzo Commento 
di byte 


byte 

((OCOLOR-MR 

TR1X)*2)) & $F 
0)|(((>SCREEN 
-BRSE)*2) & $0E) 

grmemptr 

byte 

^00001111 

grirq 

byte 

^00000001 

grirqen 

byte 

«00 

ffiobprior 

byte 

100 

mobmcm 

byte 

X00000000 

mobx2 

Ripristina 

i Vettori 


byte 

0 

currentMode 

byte 

0 

pressFlag 

byte 

1^11000000 

dispBufferOn 

byte 

0 

mouseXPos 

byte 

0 

mouseYPos 

byte 

0 

mouseOn 

word 

mousePicData 

msePicPtr 

byte 

0 

windouiTop 

byte 

199 

uindouBottom 

word 

0 

leftMargin 

word 

319 

rightMargin 

byte 

-1 

mouseDirection 

(inputData) 


;i:Sfl) puntatore alla memoria grafica 

;<Sfl) registro degli interrupt del processore 
;grafico 

;<Sfl) registro di abilitazione 
jdegli interrupt del processore grafico 
j(Sfi) priorità' degli sprite sullo sfondo 
j(SR) opzione multicolor per gli sprite 
;disabilitata 

j(Sfl) espansione x degli sprite disabilitata 

j(Sfl) ripristina i vettori del C-64 a $8314 
jcopiandoli dalla ROM del Kernel 

;<Sfì) flag degli stili di visualizzazione 
;delle fonti 

;<Sfl) nessuna pressione da gestire 

;(SR) visualizza sia sullo schermo principale 

;sia sullo schermo nascosto 

;(SR> azzera la coordinata x del mouse 

;<SR> azzera la coordinata y del mouse 

;(SR) flag che indica lo stato del mouse, 

jdei menu e delle icone 

;aggiorna msePicPtr con l'indirizzo dei dati 

;grafici del mouse memorizzati a mousePicData 

;(SR) linea superiore per il mascheramento 

;dei testi 

;(SR) linea inferiore per il mascheramento 
;dei testi 

;<SR) linea verticale sinistra per 
;il mascheramento dei testi 
;(SR) linea verticale destra per 
;il mascheramento dei testi 

;<SR) nessuna direzione impostata 
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Numero Valore Indirizzo Commento 
di byte 


word 

0 

mouseLeft 

byte 

0 

mouseTop 

word 

SCREEN-PIXEL 



-WlDTH-1 

mouseRight 

byte 

SCREEN-PIXEL 



-HEICHT-l 

mouseBottom 

byte 

tMflXIMUM 



-VELOCITY 

maxNouseSpeed 

byte 

♦HINIHUH 



-VELOCITY 

minHouseSpeed 

byte 

#I10USE 



-flCCELERflTION 

mouseflccel 

63 byte 

dati grafici 

mousePicData 

1800 

#dkgrey*16| 



Itgrey 

COLOR-MflTRIX 

byte 

tblue 

mob0clr 

byte 

tblue 

moblclr 

byte 

tblack 

extclr 

byte 

#$08 

interleave 

byte 

8 

curDrive 

byte 

8 

curDevice 

byte 

1 

numOrives 

byte 

cialcrb #$7F 

cialcrb 


byte #$83 cialtodh 


j(Sfl) limitazione sinistra di spostamento 
^orizzontale del mouse 

limitazione superiore di spostamento 
^verticale del mouse 

;(Sfl) limitazione destra di spostamento 
;orizzontale del mouse 

j(Sfl) limitazione inferiore di spostamento 
jverticale del mouse 

jimposta la velocita' massima 
;di spostamento del mouse 

jimposta la velocita' minima 
jdi spostamento del mouse 

jimposta l'accelerazione del mouse 
jdati grafici del disegno del mouse 

; riempie lo schermo con il colore 
)di fondo ottenuto componendo il grigio 
;scuro e il grigio chiaro 
;colore del mouse 

jcolore del cursore di input da tastiera 
jimposta il colore del bordo: nero 
;copia i dati grafici della freccia 
jnello sprite mouse 
)imposta a 8 l'interspazio su disco 
;inizi3lizza il disk drive tramite SetDevice 

^nuovamente inizializzato 
jporta a 1 il numero di drive attivi 
; imposta l'ora dell'orologio interno 
jpreleva il registro b di controllo 
;del Clfl 1, attiva l'orologio interno 
)e rimemorizza il valore nel registro 
jora corrente 
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Numero Valore 
di byte 

Indirizzo 

Commento 


byte 

0 

cialtodmin 

jminuti 

byte 

0 

cialtodsec 

jsecondi 

byte 

0 

cialtodl0ths 

jl/10 di secondo 

byte 

0 

minutes 

jvalore in RAM dei minuti 

byte 

0 

seconds 

jva lo re in RAM dei secondi 

jin seguito viene impostata la data corrente 

;in modo che durante gli accessi al disco 

;la data dell'ultimo aggiornamento 

;sia coerente 

byte 

36 

year 

;anno attuale 

byte 

9 

month 

;mese attuale 

byte 

20 

day 

;giorno attuale 

byte 

12 

hour 

;ora attuale 

;inizializza i flag e il vettore di allarme 

byte 

0 

alariiiSetFlag 


byte 

0 

alarmCount 


word 

0 

alarmTidtyector 

jforza qualsiasi codice turbo correntemente 
jattivo a interrompere la propria esecuzione 

jaggiorna il valore dei principali vettori 
;di sistema 

; inizio di un gruppo (SA) 

word 

0 

appllain 


word 

InterruptMain 

intTopVector 


word 

0 

intBotVector 


word 

0 

mouseVector 


word 

0 

keyVector 


word 

0 

inputVector 


word 

0 

laouseFaultyec 


word 

0 

otherPressUec 


word 

0 

stringFawltUec 


word 

0 

alarmTintyector 


word 

Panie 

BRKyector (vettore 

di gestione dell'istruzione BRK) 
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Numero Valore 

Indirizzo 

Commento 

di byte 




word RecoverRectangle recoverVector ;vettore per ripristinare 

ilo schermo principale 

SELECTION-DELflY selectionFlag 
0 alphaFlag 

ST-FLflSH iconSetFlag jil valore di default indica il flash 

jdell'icona 

0 faultData 

;fine gruppo (Sfl) 


byte 

0 

numProcesses 

byte 

0 

numberflsleep 

byte 

0 

curlconlndex 


jlnizializza i puntatori ai dati grafici degli sprite. In breve; lo spazio visto 
;d3l chip grafico e' di 16K e quindi occorrono solo 14 bit per indirizzare l'intera area, 
jl dati grafici dei disegni per gli sprite occupano 63 byte e iniziano a indirizzi che 
jsono multipli interi di 64, Quindi il disegno di ogni sprite e' conservato in memoria 
ja un indirizzo i cui 6 bit piu' bassi sono azzerati, Dal momento che i bit per indirizzare 
jlo spazio da 16K sono 14, sono sufficienti 8=14-6 bit (un byte) per individuare 
jl'indirizzo del disegno di ogni sprite nell'area da 16K 


byte 

<(spr0pic/64) 

spr0pic 

byte 

<(sprlpic/64) 

sprlpic 

byte 

<(spr2pic/64) 

sprBpic 

byte 

<(spr3pic/64) 

spr3pic 

byte 

<(spr4pic/64) 

spr4pic 

byte 

<(spr5pic/64) 

sprSpic 

byte 

<(spr6pic/64) 

spr6pic 

byte 

<(spr7pic/64) 

spr7pic 


disegna lo schermo a griglia ^memorizza una matrice grafica a griglia 

;per tutto lo schermo ($8000 • $BF3F) 

MoveShortBlock $FD30, $0314, 32 i(Sfi) ripristina i vettori del C-64 che 

jsi trovano a pagina 3 della memoria con 
)i valori riportati nella ROM del Kernel 


byte 

byte 

byte 

byte 


mike 31 1 







LE ESPANSIONI 
E GEOS 128 


RAM 


Introduzione 

Nella versione 1.3, GEOS è in grado di gestire in vari modi le espansioni di memoria 
(REU, Ram Expansion Unit). Questa è una delle caratteristiche che maggiormente 
differenziano le due versioni, ed è presente anche in GEOS 128. Nella prima parte di 
questo capitolo esamineremo le operazioni che GEOS compie in modo "trasparente” 
alle applicazioni e le possibilità d’impiego, da parte dell’applicazione, della RAM 
aggiuntiva in mansioni parallele a quelle di sistema. 

Nella seconda parte del capitolo affronteremo invece il problema della compatibilità 
di un’applicazione con GEOS 128, e i vari accorgimenti necessari per sfruttare le 80 
colonne offerte dal C-128. 

Nell’ultima parte del capitolo, infine, illustreremo tutta una serie di piccoli trucchi 
utili a ogni programmatore. Alcuni sono più che altro espedienti per aggirare i rari bug 
presenti nel Kernel di GEOS. 


Le espansioni RAM 

Il C-64, per sua natura, non è in grado di accedere a una quantità di memoria 
superiore a 64K. Questa limitazione è dovuta alle dimensioni del bus d’indirizzamento 
della CPU 6510, che, essendo formato da 8 linee distinte, può indirizzare al più 65536 
byte (64K). Di fronte a questa limitazione fisica, qualunque incremento di memoria 
sembra proprio impossibile. Invece l’ostacolo è aggirabile. Alla porta d’espansione 
(Expansion Port) del C-64 arrivano diverse linee, fra le quali sono presenti l’intero bus 
indirizzi, il bus dati e una linea che consente di disabilitare temporaneamente la CPU. 
È quindi possibile che un processore esterno possa impadronirsi temporaneamente del 
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computer ed eseguire operazioni direttamente nella memoria del C-64. Le espansioni 
di memoria sfruttano proprio questa possibilità. Sono infatti dotate di un processore 
interno in grado di eseguire poche operazioni ad altissima velocità, con grandi 
quantità di dati. La CPU del C-64 non può quindi accedere direttamente ai banchi di 
memoria contenuti nell’espansione, ma può comunicare con il processore esterno, 
passandogli alcuni parametri e ordinandogli di compiere alcune operazioni. Nel 
momento in cui il processore dell'espansione riceve il comando, disabilita il 6510 ed 
esegue le operazioni richieste interagendo con la memoria del computer e quella 
dell’espansione. I banchi sono tutti da 64K e la dimensione dell’espansione dipende 
dal numero di banchi di cui è formata. 

Per comunicare con l’espansione il 6510 deve fornire alcuni parametri: il banco di 
memoria con il quale avviene la comunicazione, l’indirizzo aU’interno del banco e 
quello all’interno del C-64 da cui deve iniziare l’operazione, e il numero di byte 
interessati. Questi parametri devono essere memorizzati in particolari registri 
dell’espansione, allocati da EXP_BASE ($DF00) in poi. Di solito in quest’area del 
campo indirizzabile non è presente alcuna memoria. Con l’inserimento dell’espansione 
diventano accessibili i re0stri di controllo del processore esterno. Quando i parametri 
sono stati impostati, il 6510 deve memorizzare nel registro comandi le operazioni 
assegnate al processore esterno. A questo punto, ogni volta che viene impartito un 
comando, il processore dell’espansione lo esegue disabilitando temporaneamente il 
6510. Il 6510 riprende il controllo solo a operazione compiuta, e non vi partecipa in 
nessun modo. L’operazione, quindi, avviene in modo del tutto “trasparente” per quanto 
riguarda il C-64. 

Le principali operazioni che si possono realizzare grazie all’espansione sono quattro. 
Ciascuna richiede un diverso comando. Il comando VERIFY consente di confrontare 
blocchi di dati delle stesse dimensioni, contenuti rispettivamente nella memoria del 
C-64 e in quella dell’espansione. Il comando STASH permette il trasferimento di un 
blocco di dati dalla memoria del C-64 all’espansione. Il comando KETCH, viceversa, 
trasferisce un blocco di dati dall’espansione alla memoria del C-64. SWAP infine 
permette di scambiare simultaneamente un blocco di dati in memoria con un blocco 
delle stesse dimensioni contenuto nell’espansione. 

Qvviamente, la quantità di memoria coivolta in ciascuna operazione non può 
superare le dimensioni del banco di memoria con cui si lavora. La velocità del 
trasferimento di dati raggiunge i 200K al secondo, e questo rende conveniente 
utilizzare le espansioni RAM anche solo per spostare ingenti quantità di dati da 
un’area all’altra della memoria del computer. 

L’ultima caratteristica importante ai fini della gestione delle espansioni in ambiente 
GEQS riguarda il reset del computer. Contrariamente a quanto si potrebbe pensare, le 
espansioni RAM non vengono coinvolte nel reset del computer e le informazioni in esse 
immagazzinate restano inalterate. Solo spegnendo il computer o cancellandole 
volontariamente è possibile perderne il contenuto. 
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GEOS e le espansioni 

Ora che sappiamo qualcosa di più sul funzionamento delle espansioni, siamo in 
grado d’illustrare come vengono impiegate dal Kernel di GEOS e quali configurazioni 
si possono ottenere. Il Kernel è in grado di “vedere” espansioni fino a 512K di memoria. 
Per essere più precisi, può interagire con ogni memoria esterna di dimensioni 
complessive non superiori ai 512K e organizzata in banchi da 64K. Le possibili quantità 
sono quindi 64K, 128K, 192K, 256K, 320K, 384K, 448K, 512K. Le azioni che può svolgere 
il Kernel dipendono anche dalla quantità di memoria esterna disponibile. 

L’utente sceglie il tipo di configurazione più conveniente alle sue esigenze 
attraverso l’applicazione Configure, che riconosce il tipo di espansione inserita e (a 
seconda della quantità di memoria aggiuntiva disponibile) offre all’utente diverse 
possibili configurazioni di sistema. 

Vi sono due operazioni che il Kernel può compiere sempre, anche con la più piccola 
espansione: muovere in maniera rapidissima aree di dati da un punto all’altro della 
memoria, e memorizzare i codici necessari per installare nuovamente il sistema senza 
che vengano compiuti accessi al disco. 

Le applicazioni che devono spostare grandi quantità di dati, come per esempio 
geoPaint quando muove la finestra di lavoro sul foglio da disegno, impiegano spesso 
la routine MoveData del Kernel di GEOS. Ma MoveData è molto lenta quando deve 
eseguire spostamenti consistenti, dal momento che deve ricorrere a un loop di 
istruzioni. Se invece è presente un’espansione, si può delegare questo compito al 
processore esterno: il Kernel non fa altro che trasferire nell’espansione l’area 
interessata, e subito dopo la ritrasferisce nel computer al nuovo indirizzo. Il tempo 
complessivo necessario all’operazione è molto inferiore a quello richiesto dal 
tradizionale loop di MoveData. Quando si sceglie questa opzione, chiamata anch’essa 
MoveData, Configure altera il sistema opportunamente in modo che MoveData 
esegua le sue funzioni impiegando l’espansione RAM. 

La seconda operazione che il Kernel è in grado di compiere con un’espansione 
consiste nel trasferimento dell’intero sistema e dei codici necessari nell’espansione, in 
modo che sia possibile riattivarlo senza accedere al disco. Con questa opzione, quando 
l’utente ordina al Kernel di cedere il controllo al Basic, l’intero Kernel viene trasferito 
nell’espansione insieme a un programma di caricamento. Per rientrare in ambiente 
GEOS, l’utente può premere il tasto “restore", oppure dare la sys 49152, o infine 
eseguire il file Rboot; l’intero Kernel viene così trasferito dall’espansione in memoria 
in meno di un secondo e gli viene subito ceduto il controllo. A questo punto il Kernel 
provvede a caricare e mandare in esecuzione deskTop. 

L’opzione ora descritta, che Configure identifica come RAM Reboot, è particolar¬ 
mente utile quando si devono mandare in esecuzione molti file non GEOS compatibili, 
rientrando ogni volta in ambiente GEOS nel tempo più breve possibile. Al rientro, la 
configurazione precedente viene mantenuta, compreso il contenuto dell’eventuale 




472 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


RAM disk, di cui parleremo fra poco. Si noti che se il Kernel sta simulando anche un 
RAM disk sull'espansione, e nel RAM disk risiede una copia di deskTop, quando il 
sistema viene riattivato dall’espansione anche deskTop viene caricata dall’espansio¬ 
ne. 

MoveData e RAM Reboot possono essere selezionate simultaneamente e non 
interferiscono con gli altri possibili impieghi dell’espansione. Se la quantità di 
memoria esterna disponibile supera i 256K, GEOS è in grado di sfruttarla per realizzare 
un drive di tipo Shadowed o RAM disk. Naturalmente queste sono opzioni alternative 
runa all’altra. Il nuovo disk drive 1541 “virtuale" che si viene a creare può essere sia 
il drive A sia il drive B. 

11 drive di tipo Shadowed è un disk drive 1541 reale affiancato a un buffer della 
stessa capacità del disco formattato. Ogni volta che l’utente carica un’applicazione o 
un file dati in memoria, il file viene trasferito nel buffer in modo che il Kernel possa 
caricarlo dal buffer (e non da disco) in tempi brevissimi, nel caso che se ne presenti 
la necessità. Ogni volta che un’applicazione salva un file su disco, il file viene copiato 
anche nel buffer. In questo modo il caricamento di tutti i file letti o salvati almeno una 
volta può avvenire direttamente dall’espansione. 

In alternativa al disco Shadowed, l’utente può configurare il Kernel di GEOS in modo 
che impieghi l’espansione RAM come un disco 1541 virtuale, ovvero come un RAM 
disk. Il disco virtuale viene identificato come drive A se il drive reale è il drive B, e 
viceversa. Per le applicazioni e per l’utente, è come se fosse collegato un secondo disk 
drive 1541. La differenza è che i file salvati sul disco virtuale vengono caricati in tempi 
brevissimi (il tempo di premere due volte il pulsante del mouse sull'icona), e i 
salvataggi dei dati su disco virtuale sono istantanei. Bisogna però ricordare che il 
contenuto del RAM disk viene completamente perso se si spegne il computer. Al 
contrario, rimane inalterato se si esegue un reset del computer e successivamente si 
ricarica GEOS. Dal momento che le due opzioni non possono convivere, l’utente deve 
decidere quale può essergli più utile quando effettua le sue scelte tramite Confìgure. 

L’applicazione Configure è di tipo AUTO-EXEC, e quindi durante il boot del sistema 
(l’installazione) viene eseguita sempre prima di deskTop. Quando riceve il controllo. 
Configure verifica il contenuto della locazione firstBoot, e se è $00 rileva che deskTop 
non è stata caricata nemmeno una volta e quindi che è in corso l’installazione. Di 
conseguenza Configure non è stata chiamata dall’utente, ma dal sistema. Provvede 
allora a configurare automaticamente il sistema secondo le specifiche che sono state 
salvate dall’utente la volta precedente, o predispone quelle di default. 

Quando invece Configure viene chiamata dall’utente, si accorge che il contenuto di 
firstBoot è diverso da $00 e decide quindi che l’utente deve ricevere il controllo per 
introdurre una nuova configurazione di sistema, che verrà salvata su disco. Da questo 
momento, quando l’applicazione verrà eseguita automaticamente dal sistema 
utilizzerà i dati salvati su disco per configurare il sistema secondo quanto stabilito 
dall’utente. 
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Tutte le possibilità operative ora descritte, offerte dal Kernel di GEOS VI.3, sono 
completamente “trasparenti’ per le applicazioni. Queste infatti non sono tenute a 
sapere se il drive B è virtuale, o se il drive A è di tipo Shadowed, dal momento che 
il sistema maschera ogni differenza, e neppure se la routine MoveData impiega il 
processore dell’espansione o no. Le applicazioni continuano a usare le routine del 
Kernel come è sempre avvenuto, cioè verificando esclusivamente se sono presenti due 
disk drive o uno solo. 


Le applicazioni e le espansioni 

Anche se GEOS è in grado di gestire efficientemente e in maniera autonoma 
l’eventuale espansione RAM* può accadere che un’applicazione desideri impiegarne 
un banco o più per svolgere compiti diversi. Per esempio, memorizzare le fonti carattere 
senza che l’espansione sia necessariamente impiegata come RAM disk. A questo 
scopo, GEOS mette a disposizione delle applicazioni cinque routine di sistema 
appositeimente realizzate per impartire comamdi all’espansione di memoria. Le 
applicsizioni possono accedere alia variabile ramExpSize per determinare il numero di 
banchi da 64K di cui è composta l’espansione correntemente inserita. Gli indirizzi 
aH’interno di ogni banco sono relativi all’inizio del banco stesso, e prescindono quindi 
dal suo numero d’ordine. Ricordiamo infine che queste routine sono disponibili solo 
nella versione 1.3 di GEOS e successive, e in GEOS 128. 
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StashRAM 


Funzione: Trasferisce un'area di dati dalla memoria del C-64 a uno dei banchi 

dell’espansione, aH’indirizzo desiderato. 

Versione: GEOS V1.3 e successive, GEOS 128 

indirizzo: $0208 


Parametri: 


rO indirizzo all'interno del C-64 

ri indirizzo all'interno del banco dell’espansione 

r2 numero di byte interessati al trasferimento 

r3L banco aH’interno dell’espansione (numerati da 0 a 7) 


Restituisce: x codice d’errore 

0 l’operaztone ha avuto successo 

DEV-NOT-FOUND numero di banco non valido, 

o espansione non presente 

Distrugge: a, y 


Sinossi: Questa routine permette alle applicazioni di trasferire nel banco r3L 

dell’espansione, e al suo indirizzo interno ri, l’area di memoria che inizia 
airindirizzo rO del C-64 ed è composta da r2 byte. 
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FetchRAM 


Funzione: Questa routine permette alle applicazioni di trasferire una particolare area di 

memoria (contenuta in un banco dell’espansione) aH’interno della memoria 
del C-64, all’indirizzo prestabilito. 

Versione: GEOS V1.3 e successive, GEOS 128 

indirizzo: $C2CB 


Parametri: 


rO indirizzo all’intemo del C-64 

ri indirizzo all’intemo del banco dell’espansione 

r2 numero di byte interessati ai trasferimento 

r3L banco all’intemo dell’espansione (numerati da 0 a 7) 


Restituisce: 

X codice d’errore 


0 


DEV-NOT-FOUND 

Distrugge: 

a. y 


l’operazione ha avuto successo 
numero di banco non valido, 

0 espansione non presente 


Sinossi: FetchRAM permette di trasferire il blocco di dati memorizzato nel banco r3L 

all’Indirizzo interno ri, e composto da r2 byte, nella memoria del computer 
all’indirizzo rO. 
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SwapRAM 


Funzione: SwapRAM consente alle applicazioni di scambiare tra loro un’area della 

memoria e un’area di uguale dimensione presente nell’espansione. 

Versione: GEOS V1.3 e successive, GEOS 128 

Indirizzo: $C2CE 


Parametri: 


rO indirizzo all’Interno del C-64 

ri indirizzo all’intemo del banco dell’espansione 

r2 numero di byte interessati allo scambio 

rSL banco all’Interno dell’espansione (numerati da 0 a 7) 


Restituisce: x codice d’errore 

0 l’operazione ha avuto successo 

DEV-MOT-FOUND numero di banco non valido, 

o espansione non presente 


Distrugge: a, y 


Sinossi: Tramite SwapRAM le applicazioni possono scambiare l’area della memoria 

del C-64 che inizia a rO, con l’area del banco r3L dell’espansione che inizia 
airindirìzzo ri. Il numero di byte interessato alio scambio è r2. 






Funzione: VerifyRAM consente di confrontare due aree di memoria, una contenuta nel 

C-64 e una nell’espansione. 

Versione: GEOS VI .3 e successive, GEOS 128 

indirizzo: $C2D1 

Parametri: rO indirizzo aH’interno del C-64 

ri indirizzo all'interno del banco dell’espansione 

r2 numero di byte interessati al confronto 

r3L banco all’interno dell’espansione (numerati da 0 a 7) 

Restituisce: x codice d’errore 

0 l’operazione ha avuto successo 

DEV-NOT-FOUND numero di banco non valido, 

o espansione non presente 

a byte di stato deil’espansione a cui è stata applicata l’operazione iogica 
AND con il valore in modo da azzerare tutti i bit tranne il 5 e ii 6 
$40 il confronto ha avuto successo 
$20 il confronto non ha avuto successo 

Distrugge: y 

Sinossi: VerifyRAM permette di confrontare l’area di memoria del C-64 che inizia a 

rO con l’area contenuta nel banco r3L dell’espansione ali’indirizzo interno ri. 
li numero di byte coinvolti nei confronto è r2. 





Funzione: Consente alle applicazioni di impartire al processore dell’espansione un 

particolare comando (è una routine di livello molto basso). 

Versione: GEOS V1.3 e successive, GEOS 128 

indirizzo: $C2D4 

Parametri: rO indirizzo aH’interno del C-64 

ri indirizzo aH’interno del banco dell’espansione 

r2 numero di byte interessati all’operazione 

r3L banco all’intemo dell’espansione (numerati da 0 a 7) 
y comando che dev’essere impartito. Per esempio: 

STASH= %10010000 
FETCH= %10010001 
VERIF = %10010011 
SWAP = %10010010 

Restituisce: x codice d’errore 

0 l’operazione ha avuto successo 

DEV-NOT-FOUND numero di banco non valido, 

o espansione non presente 

Distrugge: a, y 

Sinossi: Tramite DoRAMOp, le routine possono accedere direttamente aJ registro 

comandi dell’espansione per impartire comandi diversi da quelli riconosciuti 
dal Kernel di GEOS. Il comando dev’essere memorizzato in y. 
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Le applicazioni e la compatibilità con GEOS 128 

GEOS 128 si può considerare un parente molto stretto di GEOS VI.3 per il C-64. Tutte 
le routine riportate nella jump table di sistema di GEOS VI .3 sono fedelmente riportate 
in GEOS 128, e i parametri non sono diversi. Anche tutte le variabili di sistema 
disponibili in GEOS VI.3 sono le stesse di GEOS 128. Per queste ragioni quasi tutte 
le applicazioni prodotte dalla Berkeley Softworks per GEOS 64 possono essere eseguite 
in ambiente GEOS 128. Il “quasi” è necessario perché esiste pur sempre qualche 
differenza. Le applicazioni che devono accedere al Kernel originale del computer non 
sono compatibili con GEOS 128, per via delle sostanziali differenze presenti fra il Kernel 
del C-128 e quello del C-64. Fra queste applicazioni rientrano, per esempio, il desk 
accessory calculator e geoCalc, le quali svolgono operazioni matematiche complesse 
accedendo alle routine matematiche del computer. Se si desidera che l’applicazione 
sia comunque compatibile con entrambi i sistemi, è necessario realizzare due distinte 
tavole di salto, una per ogni Kernel. 

GEOS 128, oltre a riprodurre quasi fedelmente le caratteristiche di GEOS VI.3 per 
il C-64, ne possiede diverse, fra cui la grafica a 80 colonne. Vediamo quali sono i passi 
necessari affinché le applicazioni che sono state create esplicitamente per GEOS 64 
possano impiegare lo schermo a 80 colonne del C-128. 


La grafica a 80 colonne con GEOS 128 

Se si desidera che l’applicazione sia in grado di abilitare e gestire lo schermo a 80 
colonne offerto da GEOS 128, si devono seguire alcune direttive fondamentali. 

1) Per prima cosa è necessario che GEOS 128, caricando il file, sia in grado di 
determinare se è compatibile con il modo a 80 colonne. GEOS 128 ha bisogno di questa 
informazione perché se il modo a 80 colonne è già abilitato l’applicazione non può 
accedere allo schermo, ed è necessario avvisare l’utente o tornare automaticamente 
nel modo a 40 colonne. Quando GEOS 128 carica un file in memoria, accede alla 
locazione individuata dalla costante OFF-128-FLAGS ($96) nel File Header del file. In 
GEOS 64 questa locazione rientra nello spazio allocato per il nome permanente ed è 
sempre azzerata. In ambiente GEOS 128 questa locazione assume un particolare 
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significato. Vediamo i flag di cui è composta: 


Bit 7 Bit 6 Significato 


0 0 
0 1 

1 0 
1 1 


L’applicazione impiega solo lo schermo a 40 colonne 
L’applicazione impiega sia lo schermo a 40 colonne sia quello a 80 
colonne 

L’applicazione non può essere eseguita in ambiente GEOS 128 
L’applicazione impiega esclusivamente lo schermo a 80 colonne 


Le routine di caricamento come LdApplic e LdDeskAcc restituiscono l’errore 
INCOMPATIBLE se questi flag indicano che l’applicazione non può essere eseguita nel 
corrente modo di visualizzazione. In futuro forse anche la routine FindFTypes si 
evolverà fino a poter distinguere i file in base agli stessi criteri. 

L’applicazione deve allora riportare il valore $40 nella locazione OFF-128-FLAGS 
del suo File Header. In questo modo GEOS 128 consente entrambi i modi grafici (40 
e 80 colonne). 


2) Nel modo a 80 colonne è necessario allargare tutti i menu in modo che siano in 
grado di contenere la fonte di sistema, che è più larga. La consuetudine della Berkeley 
è quella di impostare il valore del limite destro nelle strutture dei menu sulla base del 
valore contenuto in graphicsMode ($80 per 80 colonne, $00 per 40 colonne). La 
variabile graphicsMode è prevista solo da GEOS 128 ed è allocata all’indirizzo $003F. 


3) La maggior parte dei cambiamenti nei valori grafici necessari per la compatibilità 
con il modo a 80 colonne possono essere realizzati impostando a 1 il bit 15 di tutte le 
coordinate x e di tutte le larghezze che vengono passate al sistema. Nel modo a 40 
colonne questo viene ignorato, nel modo a 80 colonne serve per adeguare tutte le 
dimensioni orizzontali. Così facendo l’immagine ha sempre le stesse dimensioni sullo 
schermo. Per esempio, la coordinata x = 50 pixel in modo a 40 colonne, dev’essere 
passata a GEOS 128 nella forma $8032, in maniera che a 80 colonne diventi $0064 (100 
pixel). 


4) Nel menu geos dell’applicazione (o in ogni caso aH’interno di qualsiasi menu) 
dev’essere disponibile la voce “switch 40/80”. La routine associata all’evento deve 
semplicemente eseguire l’operazione logica EOR fra graphicsMode e la costante $80 
(inverte il valore del bit 7), memorizzare il risultato in graphicsMode e chiamare la 
routine SetNewMode ($C2DD solo GEOS 128). In seguito l’applicazione deve 
preoccuparsi di ridisegnare lo schermo corrente nel nuovo modo grafico. Se le 
dimensioni orizzontali hanno già il bit 15 impostato a 1, la routine che ridisegna lo 
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schermo non deve subire variazioni. Ecco un esempio dei codici associati alla voce 
switch 40/80; 

SuitchDsp! 

Ida *188 

eor graphicsMode 

sta graphicsMode 

jsr SetNewMode ;IC2D0 questa routine e' disponibile solo in GEOS 128 

... .'codici per inizializzare nuovamente lo schermo 

5) L’accorgimento adottato per adeguare le dimensioni orizzontali alle 80 colonne 
(bit 15 impostato a 1) non sempre si rivela efficace. Quando il valore di una coordinata 
orizzontale viene raddoppiato per il modo a 80 colonne, inevitabilmente il bit 0 della 
word risultante è sempre azzerato. In alcuni casi questa può essere una grave 
limitazione; per esempio quando si desidera riempire lo schermo con una matrice 
grafica che si estenda fino al lato destro. Per risolvere questo problema sono state 
introdotte alcune variazioni nelle routine grafiche di GEOS 128; il bit 15 della word 
continua ad avere lo stesso significato (se è impostato a 1 fornisce l’adeguamento delle 
dimensioni al modo in 80 colonne), mentre il bit 14 dà una nuova informazione, ma 
solo nel modo in 80 colonne. Il bit 14 diventa il bit 0 della word risultante 
dall’operazione di "raddoppiamento". Se per esempio si desidera individuare il lato 
destro dello schermo, la coordinata orizzontale dev’essere $C000 + 319. 

Grazie a questi cinque accorgimenti si dovrebbe riuscire a sfruttare agevolmente il 
modo a 80 colonne del C-128. In ogni caso è possibile che siano necessari alcuni 
ritocchi nella fase di sperimentazione dei layout dell’applicazione (questo tipo di 
verifica è sempre consigliabile). 

I piccoli trucchi del mestiere 

In quest’ultimo paragrafo riportiamo una serie di piccoli accorgimenti di cui il 
programmatore dovrebbe tener conto nella realizzazione delle applicazioni. In qualche 
caso si tratta di aggirare i piccoli bug ancora presenti nella struttura di GEOS. 

1) Se l’applicazione può essere eseguita in ambiente GEOS 128, ed è in grado di 
gestire il secondo drive, si presti una particolare attenzione a tutte le chiamate della 
routine PutDirHead, e ogni volta si inserisca immediatamente prima l’istruzione jsr 
EnterTurbo. Questo accorgimento è necessario perché nella prima produzione di GEOS 
128 è presente un bug nel driver per il 1571; manca la chiamata a EnterTurbo. Il 
risultato è che in certe circostanze la chiamata a PutDirHead può anche rovinare il 
disco. Questo accorgimento non crea incompatibilità con GEOS 64. Nella prossima 
produzione di GEOS 128 il bug verrà eliminato. 
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2) Se il programma è in grado di eseguire i desk accessory, si ricordi che tutti i 
programmi Blackjack fino a oggi venduti alterano il contenuto della word a $4C95 che 
non si trova nell’area temporaneamente salvata su disco. Per porre rimedio a questo 
bug, è necessario che il codice responsabile dei desk accessory sia rispettivamente 
preceduto e seguito dalle istruzioni PushW $4C95 e PopW $4C95. Inoltre GEOS 64 non 
salva moby2 durante l’esecuzione dei desk accessory. Questo significa che gli sprite 
possono facilmente essere ingranditi in altezza dai DA e quindi modificati. Ecco un 
esempio pratico di come agire, sia sull’applicazione sia sul desk accessory: 


Applicazioni: 


Idx 

CPU-OfìTfl 

;salva lo stato di mobyS sullo stack 

LoadB 

CPU-DflTfi, #I0-IN 


PushB 

mobyB 


stx 

CPU-DflTfl 


PushW 

$4C95 

;salva il dato che BJ distruggerebbe 

CflRICflRE 

IL DESK ACCESSORY QUI 


PopW 

I4C95 

jripristina la word 

Idx 

CPU-DATR 

;ripristina r(ioby2 

LoadB 

CPU-DRTfl, #I0-IN 


PopB 

inobyB 


stx 

CPU-DRTfi 


Desk accessory: 


InitCodei 

Idx 

CPU-DRTR 

jsalva lo stato di mobyS 

LoadB 

CPU-DRTfl, #I0-IN 


Ida 

nnobyS 


sta 

savedmobyB 


Ida 

#$XX 

; imposta moby2 secondo le esigenze 

S t d 

inobyB 


stx 

CPU-DRTR 


ExitCodei 

Idx 

CPU-DflTfl 

jripristina lo stato di moby2 

LoadB 

CPU-DflTfl, #I0-IN 


Ida 

savedtnobyS 


sta 

mobyB 


stx 

CPU-DflTfl 
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3) GEOS potrebbe non funzionare correttamente se nessuna icona è stata definita. 
Se l’applicazione non impiega icone, è meglio definirne una fittizia per evitare 
problemi. Si può definirla in modo che sia alta una linea di scansione, larga un byte 
e con il puntatore ai dati grafici azzerato. 

4) In ambiente GEOS 128, non si deve mai assumere che il concatenamento dei 
blocchi della directory inizi con il settore $12/$01, o che il Directory Header Block sia 
situato all’indirizzo T/S $12/$00, perché per il 1581 il formato è diverso. Si devono 
sempre eseguire le routine GetDirHead, PutDirHead, GetlstDirEntry e GetNextDirEn- 
try presenti nel disk driver corrente. 

5) Non si deve mai cambieue con un intervento diretto il contenuto della locazione 
curDrive ($BA). Bisogna invece chiamare SetDevice per indirizzare il disk drive 
desiderato. 

6) Nei desk accessory: il codice d’inizializzazione dei desk accessory potrebbe, in 
particolari condizioni, decidere che il programma non può “girare” e quindi restituire 
subito il controllo al sistema. Questa operazione di “quit” dal codice d’inizializzazione 
non può essere realizzata direttamente. È necessario che il codice aggiorni il vettore 
appMain con l’indirizzo di una routine interna e restituisca il controllo. Dovrà essere 
poi questa routine a eseguire la procedura di chiusura del desk accessory. 

7) Nei box di dialogo: il comando DB-USR_ROUT viene eseguito prima che siano 
state disegnate le icone. Se la routine personalizzata deve disegnare qualcosa sopra 
le icone, deve impostare il vettore appMain con l’indirizzo di un’altra routine, e 
delegarla per visualizzare i disegni sopra le icone. 

8) Mai usare la routine MoveData per muovere il contenuto dei registri rO - ri 5. 

9) I box di dialogo possono gestire non più di otto icone contemporaneamente. Se 
il box deve visualizzare più di otto icone, deve gestirle autonomamente attraverso il 
vettore otherPressVec. 

10) Si ricordi che la gestione degli eventi (processi, routine puntate da keyVector e 
appMain) è attiva durante il periodo in cui un menu è aperto. La routine puntata da 
OtherPressVec è attiva in maniera parziale: analizza solo i rilasci del pulsante. Se 
l’applicazione desidera ignorare questi eventi durante l’apertura di un menu 
(situazione molto frequente) non si deve dimenticare di disabilitarli. 

11) Le chiamate a DoMenu e Dolcon muovono il mouse. Dal momento che in genere 
questo non è desiderabile, si deve agire come segue: 


PushW iiiouseXPos 
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PushB idOuseYPos 

jsr Dolcons ;o DoMenu 

PopB ffiouseYPos 

PopW ffiouseXPos 


12) Se l’applicazione interagisce con recoverVector (per ripristinare lo sfondo coperto 
da un menu o da un box di dialogo) si ricordi che la routine individuata dal vettore 
viene chiamata due volte quando si ripristina lo sfondo sottostante a un box di dialogo. 

13) I codici di interrupt di GEOS non impostano a 1 il bit del modo decimale nel PSW. 
Dal momento che i conteggi vengono svolti con questo bit azzerato, le chiamate di 
interrupt non devono mai avvenire mentre è attivato il modo decimale. 

14) Se l’applicazione disattiva (blank) lo schermo oppure scrive in grcntrll ($D011), 
ci si assicuri che il bit 7 sia sempre a 0. Dal momento che accidentalmente, nel corso 
di diverse operazioni, questo bit può diventare 1, si possono impiegare i seguenti 
codici per azzerarlo: 


Ida 

grcntrll 

jpreleva il valore corrente 

... 


;ne elabora i bit 

and 

#X01111111 

jreset bit 7 

sta 

grcntrll 

;i«effiorizza il nuovo valore 


15) Il modulo di gestione dei menu residente nel Kernel di GEOS, quando viene 
attivato dalla routine DoMenu, memorizza nel vettore mouseFaultVec l’indirizzo di una 
routine interna che controlla la chiusura del menu corrente quando il mouse ne 
oltrepassa i bordi. Questo impiego del vettore mouseFaultVec, quando è attiva una una 
struttura di menu, può entrare in conflitto con l’applicazione qualora questa desideri 
usare mouseFaultVec per altri scopi. La soluzione al problema si ottiene con due 
interventi, uno nella routine d’inizializzazione dell’applicazione, uno nella routine di 
servizio che l’applicazione desidera assegnare al vettore mouseFaultVec. 

Primo intervento. Quando l’applicazione vuole usare mouseFaultVec e contempora¬ 
neamente una struttura di menu, la routine d’inizializzazione deve, dopo la chiamata 
a DoMenu, memorizzare in un vettore interno il contenuto del vettore mouseFaultVec. 
Compiuta questa operazione, può memorizzare in mouseFaultVec l’indirizzo della 
routine di servizio che si desidera assegnare al vettore. 

Secondo intervento. La routine di servizio associata a mouseFaultVec, quando riceve 
il controllo, deve verificare se la propria esecuzione è stata richiesta dal sistema in 
quanto il mouse ha oltrepassato uno dei limiti posti dall’applicazione. In caso 
affermativo, può compiere le sue funzioni e restituire il controllo a MainLoop con 
l’istruzione rts. In caso contrario, deve cedere il controllo alla routine il cui indirizzo 
è stato memorizzato nel vettore interno dalla routine d’inizializzazione. 




A APPENDICE A: 
COSTANTI 


-nmmmnmmntmnmmtmnnmmnuunumumnnmmmmmunu 

f 

geosConstants 

f 

; Questo file contiene le costanti da impiegare nelle applicazioni GEOS compatibili 


•,ttttununtunnttunutttnuittnttuttntnt%tnnnt%nnuttnuunnunutun 

TRUE - -1 

FALSE = 0 

jLe costanti che seguono vengono utilizzate nel registro CPU-DRTA ($0001 per il C-64, 

;$FF00 per il C-128) per impostare la configurazione RRH/RON della mappa di memoria 

IO-IN » $35 ;60K RAM, 4K di spazio I/O attivati 

RRI1-64K = $30 ;64K RAM 

KRNL-BAS-IO-IN = $37 jROM del Kernel, del Basic e spazio di I/O 

jattivati 

KRNL-IO-IN - $36 jROM del Kernel e spazio di I/O attivati 

jper il C-128 


CIO-IN 

CRRH-64K 


= $7E 
= $7F 


)60K RAM, 4K di spazio I/O attivati 
j64K RAM 
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CKRNL-BflS-IO-IN 

CKRNL-tO-IN 


= $40 jKernel, I/O e Basic attivati 

= $4E jKernel e I/O attivati 


; Costanti Generali 


PROMPT-DELRY 

= 

60 

jII valore massimo e' 63 

VERT-SPflCE 

= 

2 


HORI-SPflCE 

= 

4 


POSITIVE 


X00000000 


NEGRTIVE 

= 

X10000000 



; Menu 


tIfiX-ME-ITEMS = 15 

MfiX-flE-NESTING = 4 

DflTfl-BUFFER-SIZE = 8 

PUTCHflR-BUFFER-SIZE = 8 


HORIZONTfiL 

WERTICflL 

CONSTRflINED 

UN-CONSTRflINED 


X00000000 
X10000000 
X@1000000 
X00000000 


jRitardo <delay) fra le due inversioni dell'opzione selezionata di un menu 

SELECTION-DELflY = 18 jl/6 di secondo 

;0ffset per le variabili aH'interno della struttura di definizione dei menu 

OFF-MY.TOP = 0 jOffset alla coordinata y del lato superiore 

;del menu 

jOffset alla coordinata y del lato inferiore 
;del menu 


OFF-HY-BOT 


1 
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OFF-HX-LEFT 

— 

2 

jOffset alla coordinata x del lato sinistro 
;del menu 

0FFJ1X-RIGHT 

ss 

4 

jOffset alla coordinata x del lato destro 
;del Menu 

0FF-NUI1I1-1TEMS 

* 

6 

;0ffset all'indicatore 

;di allineamento|iiioviiiiento{nuiiiero di voci 

OFF-IST-M-ITEM 

ss 

7 

jOffset al primo gruppo di dati 
jdi definizione della prima voce 

SUB-MENU 

= 

$80 

jQueste costanti vengono utilizzate per 
jindicare se la singola voce del menu 

DYN-SUB-MENU 

— 

$40 

jcausa un evento o l'apertura 
;di un sotto-menu 

MENU-flCTION 

ss 

$00 



; Processi 


MfiX-PROCESSES 


20 

jQuesto e' il massimo valore che può 
jcontenere la variabile numProcesses 
jallocata all'indirizzo $8770 

SLEEP-MflX 


20 


jValori possibili per le 

variabili allocate da processFlags ($8719) in poij non 

jdirettamente accessibili 

per 

le applicazioni 


SET-RUNflBLE 

= 

X10000000 

jFlag processo eseguibile 

SET-BLOCKED 

= 

X01000000 

jFlag processo bloccato 

SET-FROZEN 

= 

X00100000 

jFlag processo congelato 

SET-NOTIMER 

= 

X00010000 

jFlag processo non temporizzato 

RUNflBLE-BIT 

= 

7 

jBit del Flag eseguibile 

ELOCKEO-BIT 

= 

S 

jBit del Flag bloccato 

FROZEN-BIT 

= 

5 

jBit del Flag congelato 

NOTIMER-BIT 

= 

4 

jBit del Flag non temporizzato 


; Testo 


;Costanti per la variabile currentMode 
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SET-UNDERLINE 

= 

^10000000 


SET-BOLD 


X01000000 


SET-REVERSE 

at 

1^00100000 


SET-ITfìLIC 

= 

^00010000 


SET-OUTLINE 

= 

5:00001000 


SET-SUPERSCRIPT 

= 

5:00000100 


SET-SUBSCRIPT 

» 

5:00000010 


SET-PLflINTEXT 

ss 

5:00000000 


UNDERLINE-BIT 

= 

7 


BOLD-BIT 

= 

6 


REVERSE-BIT 

= 

5 


ITfiLIC-BIT 

= 

4 


OUTLINE-BIT 

= 

3 


SUPERSCRIPT.BIT 

= 

2 


SUBSCRIPT-6IT 

= 

1 


jCostanti per la 
; impiegare anche 

routine PutString le costanti 
con PutChar 

indicate con un asterisco si possono 

EOF 


0 

;Fine del testo 

NULL 

= 

0 

jFine della stringa 

BflCKSPflCE 

= 

8 

;t muove a sinistra di uno spazio carattere 

TflB 

= 

9 

^Tabulatore 

FORWfiRDSPflCE 

= 

9 

muove a destra di uno spazio 

LF 

s 

10 

muove verso il basso di una riga 

HOME 

= 

11 

muove all'angolo superiore sinistro dello 
; schermo 

URLINE 

= 

12 

muove verso l'alto di una riga 

PfiGE-BREfiK 

= 

12 

;Fine pagina 

CR 


13 

muove all'inizio della riga successiva 

ULINEON 

= 

14 

attiva lo stile sottolineato 

ULINEOFF 

8 

15 

disattiva lo stile sottolineato 

ESC-GRflPHICS 

= 

16 

;Codice di controllo per la stringa grafica 

ESC-RULER 


17 

;Codice di controllo per la riga 
;di definizione 

REU-ON 

= 

18 

attiva l'output su schermo in negativo 

REV-OFF 

= 

19 

;t disattiva l'output su schermo in negativo 

GOTOX 

= 

20 

;Utilizza la word successiva come nuova 
;coordinata x del cursore 

GOTOY 

S 

21 

jUtilizza il byte successivo come nuova 
;coordinata g del cursore 
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GOTOXY 

= 

22 

jUtilizza la uord e il byte successivi 
;come nuove coordinate x e y del cursore 

NEWCflRDSET 

ss 

23 

;La uord che segue indica il FontlD, e 
;il byte successivo lo stile 

BOLDON 

= 

24 

j* attiva lo stile nero 

ITflLICON 

= 

25 

ìt attiva lo stile corsivo 

OUTLINEON 

= 

26 

attiva lo stile outline 

PLfìINTEXT 

= 

27 

j* attiva lo stile tondo 

USELflST 


127 

;Cancella carattere 

SHORTCUT 

= 

128 

jCarattere shortcut (il carattere Commodore) 


; Tastiera 

KEY-QUEUE-SIZE = 16 jOimensione della coda (buffer) di tastiera 

KEY-REPEflT-COUNT = 15 jl/4 di secondo; tempo di auto-repeat 

jper la tastiera (massimo 254 e non 255) 


KEY-INVflLID 

= 31 

KEY-Fl 

= 1 

KEY-F2 

= 2 

KEY-F3 

3 

KEY-F4 

= 4 

KEY-F5 

5 

KEY-F6 

= 6 

KEY-F7 

= 14 

KEY-F8 

= 15 

KEY-UP 

16 

KEY-DOWN 

= 17 

KEY-HOHE 

18 

KEY-CLEflR 

= 19 

KEY-LflRROW 

= 20 

KEY-UPflRROW 

= 21 

KEY-STOP 

= 22 

KEY-RUN 

= 23 

KEY-BPS 

- 24 

.ifdef 

C-128 

■ if 

C-128 
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KEY-HELP 

KEY-flLT 

KEY-ESC 

KEY-NOSCRL 

KEY-ENTER 

.endif 

■endif 

KEY.LEFT 

KEY-RIGHT 

KEY.DELETE 

KEY-INSERT 


25 

26 
27 
7 
11 


BfICKSPftCE 

30 

29 

28 


; Mouse 


MOUSE-flCCELERflTION 

= 

127 

;Rccelerazione del 

mouse 

MflX-VELOCITY 

= 

127 

.'Velocita' massima 

del mousi 

MIN-VELOCITY 

= 

30 

{Velocita' minima 

del mouse 

SET-MSE-ON 

* 

'■10000000 



SET-MEHUON 

= 

■/.0 1000000 



SET-ICONSON 

= 

X00100000 



MOUSEON-BIT 

s 

7 



MENUON-BIT 

= 

6 



ICONSON-BIT 

sa 

5 




; Grafica 


jCostanti per le dimensioni dello schermo 


, ifdef 
,if 

SC-BYTE-WIDTH 


C-128 

C-128 


;C-128 a 80 colonne 
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SC-PIX-WIDTH 


640 


.else 

SC-BYTE-WIDTH 

= 

40 

;C-128 a 40 colonne 

SC-PIX-MIDTH 

= 

320 


, endif 

.else 

SC-BYTE-WIDTH 

= 

40 

;C-64 a 40 colonne 

SC-PIX-WIDTH 

= 

320 


.endif 

SC-PIX-HEIGHT 

s 

200 


SC-SI2E 

= 

SC-PIX-WIDTH * SC-PIX-HEIGHT 

iCostanti per 

controllare i bit 

di dispBufferOn 

jdispBufferOn controlla quale schermo e' 

interessato dai comandi grafici 

ST-WR-FORE 

sr 

$80 

;Scrive sullo schermo principale 

ST-WR-BflCK 

= 

140 

jScrive sullo schermo nascosto 

ST-WRGS-FORE 

jl/alori per la 

stringa grafica 

$20 

;La stringa grafica agisce solo 
jsullo schermo principale 

MOyEPENTO 

= 

1 

jMuove il pennello alla coordinata x, y 

LINETO 

= 

2 

; Disegna una linea a x, y 

RECTflNGLETO 

= 

3 

; Disegna un rettangolo a x, y 

;PENFILL 


4 

jRiempie con la matrice grafica corrente^ 
jquesto comando non e' ancora disponibile 
jnel Kernel, e viene ignorato se presente 

NEWPflTTERN 

= 

5 

;Seleziona una nuova matrice grafica 

ESC-PUTSTRING 


6 

jinizia l'interpretazione dei dati che 
;seguono come per la routine i-PutString 

FRflME-RECTO 

= 

7 

iCrea il bordo (cornice) a un rettangolo 

PEN-X-DELTfl 


8 

)Muove il pennello orizzontalmente 
;di una distanza specificata dalla uord 
jsegnata che segue 

PEN-Y-DELTfl 


9 

jHuove il pennello verticalmente 
;di una distanza specificata dal byte 
; segnato che segue 

PEN-XY-DELTfl 


10 

;Muove il pennello delle distanze specificate 
;dalla uord e dal byte segnati che seguono 
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;I colori riconosciuti dal processore VlC 


BLACK 

WHITE 

RED 

CYAN 

PURPLE 

GREEN 

BLUE 

YELLOW 

ORRNGE 

BROUN 

LTREO 

OKGREY 

GREY 

MEDGREY 

LTGREEN 

LTBLUE 

LTGREY 


= 0 
= 1 
= 2 
= 3 
= 4 
= 5 
= 6 
= 7 
= 8 
= 9 
= 10 
= 11 
= 12 
= GREY 
= 13 
= 14 
= 15 


;Valori per la routine PutDecimal 

jGiustificazione a sinistra 
jGiustiFicazione a destra 
;Tronca gli zeri 
;Non tronca gli zeri 


SET-LEFTJUST 
SET-R IGNI JUST 
SET-SUPRESS 
SET-NOSUPRESS 


•^10000000 

^00000000 

1^01000000 

X00000000 


; Icone 

; xnnnnttnnnuunnnunntnnnnnunnnnuunuttnnnununuttnnttn 


CLICK-COUNT = 30 jNumero di interruzioni da contare 

jQuesta costante viene utilizzata per 
;inizializzare la variabile dblClickCount 
jquando un'icona viene selezionata 
;la prima volta. dblClickCount viene 
jdecrementata a ogni interrupt, e se non 
;vale 0 quando l'icona viene nuovamente 
;selezionata, il flag della doppia pressione 
;(r0H) viene passato alla routine 
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;di servizio dell'icona con il valore TRUE 
;Se dblClickCount vale 0 quando l'icona 
;viene selezionata^ il flag viene passato 
jcon il valore FALSE 

;Le seguenti costanti contengono i valori per la variabile iconSetFlag, Questi valori 
; indicano come viene segnalata all'utente la selezione di un'icona. Se e' impostato ST-FLRSH, 
jST-INVERT non ottiene alcun effetto 


ST-FLASH 


= $80 

)Bit per indicare che quando l'utente seleziona 
;riconaj questa deve invertirsi per un istante 

ST-INWERT 


$40 

jBit per indicare che quando l'utente seleziona 
; l'icona, questa deve invertirsi 

;0ffset all'interno 

della 

struttura 

di definizione delle icone 

OFF-NM-ICNS 


= 0 

jOffset al bgte che specifica il numero di icone 
;nella struttura 

OFF-IC-XMOUSE 


= 1 

,'Offset alla word che specifica la coordinata x 
idei mouse 

OFF-IC-YMOUSE 


= 3 

jOffset al bgte che specifica la coordinata y 
;del mouse 

;0ffset all'interno 

di un 

gruppo di 

dati di definizione di un'icona 

OFF-PIC-ICON 


= 0 

;0ffset al puntatore ai dati grafici dell'icona 

OFF-X-ICON-POS 


= 2 

;0ffset alia coordinata x dell'icona 

OFF-Y-ICON-POS 


3 

;0ffset alla coordinata y dell'icona 

0FF-WDTH.1C0N 


4 

;0ffset alla larghezza dell'icona 

OFF-HEIGHT-ICON 


= 5 

(Offset all'altezza dell'icona 

OFF-SRV-RT-ICON 


= 6 

(Offset al puntatore alla routine di servizio 
(deir icona 

OFF-NX-ICON 


= 8 

(Offset all'icona successiva nella struttura 


;di definizione delle icone 


; Flag 


jValori per pressFlag 
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KEYPRESS-BIT 

= 

7 

jAltra pressione 



INPUT-BIT 

= 

6 

;Cambiamenti di 

stato nel dispositivo 

di 

input 

MOUSE-BIT 

= 

5 

jPressione del 

pulsante del mouse 



SET-KEYPRESS 

= 

/'10000000 

jRltra pressione 



SET-INPUTCHG 

= 

^01000000 

;Cambiamenti di 

stato nel dispositivo 

di 

input 

SET-MOUSE 


^00100000 

jPressione del 

pulsante del mouse 



jUalori per faultData 







OFFTOP-BIT 


7 

jSconfinamento 

in alto del mouse 



OFFBOTTOM-BIT 

= 

6 

jSconfinamento 

in basso del mouse 



OFFLEFT-BIT 

= 

5 

jSconfinaraento 

a sinistra del mouse 



OFFRIGHT-BIT 

= 

4 

jSconfinamento 

a destra del mouse 



OFFMENU-BIT 

= 

3 

jSconfinamento 

del mouse dai bordi di 

un 

menu 

SET-OFFTOP 


X10000000 

jSconfinamento 

in alto del mouse 



SET-OFFBOTTOM 

= 

^01000000 

jSconfinamento 

in basso del mouse 



SET-OFFLEFT 

= 

^00100000 

jSconfinamento 

a sinistra del mouse 



SET-OFFRIGHT 

= 

7,00010000 

jSconfinamento 

a destra del mouse 



SET-OFFMENU 

■ 

*400001000 

jSconfinamento 

del mouse dai bordi di 

un 

menu 

RNY-FRULT = SET-OFFTOP|SET-OFFBOTTOM|SET-OFFLEFT|SET-OFFRIGHT|SET-OFFMENU 




; Tipi dei file GEOS 


jQuesti valori sono memorizzati nel File Entry dei file e indicano il tipo del file 
;in ambiente GEOS 

NOT-GEOS = 0 jFile C-S4 non compatibile con GEOS 

jLe seguenti costanti sono tipi di file GEOS predisposti per mantenere la compatibilita' 
jcon i file C-64 precedenti. Questi file hanno semplicemente il File Header Block 
je il File Entry aggiornato, In genere i tipi BASIC e RSSEiIBLY sono caricabili 
jda deskTop e vengono eseguiti con il Basic attivato 

BASIC = 1 ,'Programma in Basic C-64 con un blocco File Header 

jassociato (tipo Commodore PRO, Questo tipo può' 
;essere utilizzato con programmi che normalmente 
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fiSSEMBLY 


DATA 


;Le costanti che seguono 
ji file identificati con 
;Coiiiiiiodore USR 

SYSTEM 

DESK-ACC 

APPLICATION 

APPL-DATA 

FONT 

PRINTER 

INPUT-DEVICE 

DISK-DEVICE 

SYSTEM-BOOT 

TEMPORARY 


;verrebbero caricati ed eseguiti in questo modo; 

;LOAD “FILE"; 8 

jRUN 

= 2 iPrograimna in Assentbly C-64 con un blocco File 

;Header associato (tipo Commodore PRO). Questo 
jtipo può' essere utilizzato con programmi che 
;normalmente verrebbero caricati ed eseguiti in 
jquesto modo: 

;L0A0 "FILE"; 8; 1 

jSYS (Indirizzo d'esecuzione) 

= 3 ;File di dati non eseguibile (PRG; SEQ; USR) 

)con un blocco File Header associato 

indicano i tipi GEOS per i file applicazioni e di sistema, Tutti 
uno dei tipi GEOS che seguono dovrebbero essere di tipo 


4 jFile di sistema GEOS 

5 )File accessori da scrivania GEOS 

6 jFile applicazioni GEOS 

7 jFile dati per un'applicazione GEOS 

8 jFile fonte carattere GEOS 

9 jOriver di stampa GEOS 

10 jOriver del dispositivo di input GEOS 

11 jOriver del disk drive GEOS 

12 jFile GEOS di caricamento del sistema (GEOS; 
jGEOS BOOT; GEOS KERNEL) 

13 jFile temporaneo, deskTop cancella automatica- 
jmente tutti i file di questo tipo presenti sul 
jdisco che sta aprendo. Quando l'applicazione 
jdeve creare un file temporaneo; deve 
jutilizzare il tipo TEMPORARY e iniziare il 
jnome del file con il carattere di controllo 
jPLAINTEXT, Per esempio: 

jsuapName: 

j,byte PLAINTEXT; "My suap file'';0 
jin questo modo ci si assicura che il file 
jtemporaneo non vada a sostituire un file 
jsu disco con lo stesso nome 
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flUTO-EXEC 

* 14 

jRpplicazione che dev'essere automaticamente 
; caricata e mandata in esecuzione dopo 
j 1 'installazione del sistema, ma prima che sia 
jeseguita deskTop. Questo tipo viene riconosciuto 
jsolo dalla versione 1,3 del Kernel e successive 

INPUT-128 

= 15 

;0river di input per il 128 

.ifdef 

C-128 


.if 

C-128 


NUM-FILE-TYPES 

16 

jNumero di tipi dei file ammessi da GEOS 
;(compreso il tipo 0 NOT-GEOS) 

.endif 

.else 

NUM-FILE-TYPES 

= 15 

;Numero di tipi dei file ammessi da GEOS 
;(compreso il tipo 0 NOT-GEOS) 

,endif 


jTipi di struttura dei file gestiti da GEOS 
jOgni tipo di struttura identifica 
; l'organizzazione dei blocchi del file 
jsu disco, e non ha attinenza con il formato 
;dei dati nei blocchi 

SEQUENTIflL 

0 

jStruttura a blocchi T/S concatenati (come per 
jesempio i file Commodore PRG e SEQ) 

VLIR 

1 

;Struttura a record indicizzati di lunghezza 
;variabile (utilizzata per fonti carattere, 
;documenti ecc,). Questa struttura e' usata 
;solo in ambiente GEOS 


; Tipi dei file Commodore 

; nnnntnuuuuuinuuuuuuutttuuuuutuuuuttuutuutttuutuuuutu 


;Sono i tipi dei file riconosciuti dal DOS del 1541 


DEL 

= 

0 

;File 

DELeted (cancellato) 

SEQ 

= 

1 

jFile 

SEQuential (sequenziale) 

PRG 

= 

2 

;File 

PRoGram (programma) 




APPENDICE A: COSTANTI 


497 


USR 

- 

3 

jFile USeR (utente) 

REL 


4 

;File RELative (relativo) 

CBN 


5 

;File di protezione della BRÌI, attualmente 
jinstallato solo nel drive 1581. Viene impiegato 
;per proteggere particolari blocchi e tracce del 
jdisco dall'esecuzione del comando Validate 

TOTflL-BLOCKS 

= 

€64 

jNunero di blocchi su disco, senza includere la 
; traccia della directory 


1 tttttnuttttttttttttttttttttttttntttttttttttunttttttttnintttttttuttmttnttttmn 

1 II Directory Header Block 

■ mmtmmmmnmttmmmtmnmmmtmmmmmmmmmmmmm 


OFF-TO-BfiM 

ss 

4 

;0ffset alla prima entry nella BRM 

OFF-OISK-NflME 

= 

144 

;0ffset alla stringa contenente il none del disco 

OFF-OP-TR-SC 


171 

;0ffset all'indirizzo T/S del blocco Off Page 
jcontenente gli 8 File Entry dei file riposti 
;sulla scrivania 

OFF-GS-ID 


173 

{Posizione nel Directory Header Block della 
{Stringa di identificazione GEOS 

OFF-GS-DTYPE 


188 

{Posizione dove si trova il tipo di disco nel 
{formato GEOS. Rttualnente e' 0 per i dischi 
{nomali, 'B' per i dischi di caricanento 
{(BOOT) e 'P' per i dischi Master. Questa 
{locazione e' azzerata sulle copie destinazione 
{di qualsiasi disco 

OFF-GS-SERIflL 

= 

190 

{Posizione nella quale deskTop, e alcune 


applicazioni CEOS^ nenorizzano il nuaero di serie 
del Kernel. Questo accorgiaento e' riservato 
solo a dischi di tipo 'B' e 'P'. Si rivela 
utile nel caso che l'utente rovini il proprio 
disco GE03, e noi debbiano spedirgliene 
un altro in sostituzione. Il progranna di 
installazione legge il nunero di serie 
nenorizzato sul naster disk, e aggiorna 
il nunero di serie del Kernel per il disco 
sostitutivo. Notai Questa informazione e' 
Memorizzata in una uord. Il nunero seriale, 
prima di essere memorizzato, viene ruotato a 
sinistra di un bit. Sui dischi di copia, 
questa locazione viene azzerata 
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; File Entry 


ST-WR-PR 


$40 

jBit di protezione del file, bit 6 del byte 0 
jnel File Entry. Questa costante e' utilizzabile 
jper verificare e/o impostare lo stato del bit 
jdi protezione dei file Commodore 

FRST-FILE-ENTRY 

3 

2 

jOffset al primo File Entry nel blocco 




;della directory 

;0ffset all'interno di 

un File 

Entry 


OFF-CFILE-TYPE 

- 

0 

;0ffset all'indicatore del tipo standard 
jCommodore del file 

OFF-INDEX-PTR 

= 

1 

;0ffset al puntatore T/S del blocco indice 
j(struttura VLIR) 

OFF-DE-TR-SC 

* 

1 

;0ffset al puntatore T/S del primo blocco 
;del file (struttura SEQ) 

OFF-FNRtlE 


3 

;0ffset al nome del file 

OFF-GHDR-PTR 

* 

19 

jOffset all'indirizzo T/S del blocco File Header 
;del file 

OFF-GSTRUC-TYPE 


21 

jOffset all'identificatore della struttura GEOS 
jdel file 

OFF-GFILE-TYPE 


22 

jOffset all'indicatore del tipo GEOS del file 

OFF.YEfiR 

3 

23 

jOffset al byte anno (primo byte della data) 

OFF-SIZE 

= 

28 

jOffset alla dimensione del file in blocchi 

OFF-NXT-FILE 


32 

jOffset al File Entry seguente nel blocco della 
jdirectory 


; Il blocco File Header 


;0ffset aH'interno del blocco File Header di un file 

0-GHIC-WIDTH = 2 jByte che indica la larghezza in byte 

jdell'icona associata al file 

0-GHIC-HEIGHT = 3 ;Byte che indica l'altezza in byte dell'icona 
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0-GHIC-PIC 

= 

4 

j64 byte per il disegno dell'icona 

O-GHCMDR-TYPE 

= 

68 

jTipo CoffliDodore del file per il File Entry 

O-GHGEOS-TYPE 

= 

69 

jTipo GEOS del file per il File Entry 

0-GHSTR-TYPE 

== 

78 

^Struttura GEOS del file 

O-GHST-flODR 


71 

jUord, indirizzo di caricamento del file 
j(da dove e' stato salvato) 

O-GHENO-flDDR 

= 

73 

jWord, indirizzo di fine file in memoria 

0-GHST.VEC 

ss 

75 

jWord; indirizzo di esecuzione se il file 
;e' un'applicazione 

O-GHFNflME 

= 

77 

j20 byte, nome permanente 

0-128-FLflGS 


96 

;Byte contenente alcuni flag che indicano se 
j1'applicazione e' in grado di funzionare in 
;ambiente GEOS 128 a 40 colonne e a 88 colonne 
,'Questi flag interessano i file di tipo 
;flPPLlCfiTION, OESK-flCC, e fiUTO-EXEC 
;Bit Significato 

;7 0 se funziona in modo a 48 colonne 
j6 1 se funziona in modo a 88 colonne 

O-GHFONTID 


130 

;Se il file e' una fonte carattere, offset 
jai 10 bit contenenti il numero Font IO della 
;fonte. Questa informazione identifica anche 
;il primo corpo carattere della fonte 

O-GHPOINT-SIZE 


132 

;Se il file e' una fonte carattere, offset alla 
;lista dei corpi carattere disponibili (massimo 
;15 corpi) 

0-GHSET-LENGHTS 


97 

jSe il file e' una fonte carattere, offset alle 
jdimensioni, in byte, di ogni set all'interno 
;della fonte. I set disponibili sono listati a 
jO-GHPOINT-SIZE. Ogni dimensione e' composta 
;da due byte 

0-GHP-DISK 


97 

;20 byte, nome del disco sul quale si trova 
; l'applicazione parente (solo se il file e' 
jun file dati). GH ultimi 4 caratteri sono 
jnulli, mentre i caratteri 12-15 sono 
jla versione (per esempio, 1.3) 

O-GHP-FNflME 

s* 

117 

i20 byte, nome dell'applicazione parente 
j(solo se il file e' un file dati) 

O-GH-fiUTHOR 


97 

iOffset al nome dell'autore. Occupa lo stesso 
;spazio nel blocco utilizzato per il nome 
jdel disco parente in quanto le due informazioni 
;non possono essere presenti contemporaneamente 
jnel file 
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O-GHINFO-TXT = tfl0 ;0ffset allo spazio nel blocco allocato per 

;contenere il testo associato al file che 
;cospare nel box get info di deskTop 

; unnmtumnmmmmmtnmmttninnmnmmnttntnmtnnnmmttn 

; Costanti per la routine GetFile 

; utntnnututuntununutnututuunutuunnntttttttnntttnttttttntttun 

;Le costanti che seguono definiscono le opzioni di caricantento per la routine GetFile e, in 

; 9 enerale, per tutte le routine di caricanento da disco (Ldxxxx). Queste costanti si usano 

iper impostare lo stato dei bit contenuti nei registro loadOpt 

ST-LD-flT-flDDR = $01 ;Carica il file all'indirizzo specificato e non 

;a guello originario 

ST-LO-DfITft = $80 jfSolo per le applicazioni) il caricamento e' 

;avvenuto tramite la selezione di un file dati 
;L'applicazione deve caricare ed elaborare 
jil file dati selezionato, il cui nome e' 
jpuntato da r3 

ST-PR.DftTfl = $40 ;(Solo per le applicazioni) il caricamento 

;deU'applicazione e' avvenuto per stampare un 
ifile dati. L'applicazione riceve in r3 
;il puntatore al nome del file da stampare 


ì mmmmmmmmmmmtmmmmmmmmmmmmmmmmttmm 

1 Disco 

; mmmmmmmmmmtmmmmmmmmmmmmmmmmmmmtt 

;Costanti per le routine d'accesso al disco di basso livello 


N-TRflCKS 


35 

jNumero di tracce 
jper il 1541 

disponibili sui dischi 

OIR-TRflCK 

sai 

18 

^Traccia sul disco 

riservata per la directory 

0IR-1581-TRflCK 

_ 

40 

jTraccia sul disco 

riservata per la directory 


;in un disk drive ISSI 

jLe costanti per la variabile “driveType" 

;i due bit piu' significativi in driveType 
;hanno particolari significati (non possono 
;essere impostati a 1 contemporaneamente); 

;Bit 7; se impostato a 1, disco virtuale su RfìH 
;6it 6; se impostato a 1, shadoued disk 
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DRy-HULL 

ss 

0 

{Non e' presente alcun drive all'indirizzo 
{di dispositivo corrente 

ORV-1541 

= 

1 

{Disk drive Commodore 1541 

DRV-1571 

= 

2 

{Disk drive Commodore 1571 

DRV-1581 

= 

3 

{Disk drive Commodore 1581 

DRV-NETWORK 

= 

15 

{Drive per GEOS geoNet "drive" 

DK-NM-IO-LEN 

{Comandi d'accesso al 

disco 

18 

{Numero di caratteri che compongono il nome 
{del disco 

MflX-CtINO-STR 

- 

32 

{Lunghezza massima di una stringa comandi 
{per il drive 

DIR-flCC-CHflN 

= 

13 

{Canale di default per l'accesso diretto 

REL-FILE-NUM 

= 

9 

{Numero logico e canale per i file relativi 

CHND-FILE-NUM 

= 

15 

{Numero logico e canale per i file comandi 

{Le due costanti che 

seguono 

individuano. 

all'interno di un buffer contenente 

{una stringa comando, 

i numeri di traccia 

e settore per l'accesso diretto ai disco 

TRflCK 

« 

9 

{Offset al byte basso contenente il codice 
{ASCII del numero decimale della traccia 

SECTOR 


12 

{Offset al byte basso contenente il codice 


;RSCII del numero decimale del settore 

; Errori da disco 

;Le costanti che seguono individuano i codici d'errore restituiti dalle routine che 

;effettuano accessi diretti al drive 

N0T-6L0CKS = 1 ;Questo errore viene restituito quando 

;il numero di blocchi da trasferire non 
jcorrisponde a quello incontrato dalie routine 
;GetBlocks o PutBlocks, Per esempio, questo 
{codice viene restituito da GetBlocks se 
{incontra l'ultimo blocco del file prima che 
{Sia stato trasferito il numero di blocchi 
{richiesto 
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INV-TRflCK 

INSUFF-SPfiCE 

FULL-DIRECTORV 


FILE-NOT-FOUNO 

BflD-BflM 


UNOPENED-WLIR 


INV-RECORD 


2 jQuesto errore si verifica quando si tenta di 
/•accedere^ in scrittura o in lettura, 

jal settore di una traccia inesistente 
j(traccia B o traccia > N-TRflCKS) 

3 jE' restituito da Blockfllloc o SaveFile se il disco 
jnon contiene il numero di settori allocabili 
^necessario 

4 jQuesto errore viene restituito da GetFreeDirBlk 
jse dalla pagina della directory fino aU'ultimo 
jblocco non e' presente neanche un File Entry 
jlibero, Notai se non vengono utilizzati tutti i 18 
jblocchi possibili, GetFreeDirBlk aggiunge una 
jpagina alla directory, ma se tutti i blocchi sono 
;gia' stati allocati viene restituito il codice di 
jerrore per indicare che dalla pagina indicata 
jfino al termine della directory non sono presenti 
jblocchi liberi. La presenza di questo errore non 

jindica necessariamente che la directory non 
jcontiene neanche un File Entry libero, ma solo 
jche non sono presenti File Entry liberi 
jdalla pagina indicata fino al termine della 
jdirectory. Se la pagina da cui parte la ricerca 
je' la numero 0, questo codice d'errore indica che 
jla directory e' completamente piena e non può' 
jcontenere altri File Entry (in questo caso i file 
jpresenti sul disco sono 144) 

5 jViene restituito quando, scorrendo la directory, 
jil file richiesto non viene incontrato 

6 jIndica che la BAH memorizzata nel buffer 
jCurDirHead presenta un errore: 

jl) il numero di blocchi liberi non corrisponde a 
jquello ottenuto calcolando i bit della BAH 
j2) durante la cancellazione di un file, un blocco 
jdel file presenta già' nella BAH lo stato di 
jdisallocato (libero) 

7 jQuesto errore si verifica quando si tenta 

jl'accesso a un record di un file VLIR prima che 
jquesto sia stato aperto con la routine 
jOpenRecordFile 

8 jQuesto errore si verifica quando si tenta 
jl'accesso a un record del file VLIR che non esiste 
jQuesto errore non e' fatale, e può' essere 
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OUT-OF-RECORDS 


STRUCT-IIISIIflT 


BFR-OVERFLOW 


CfiNCEL-ERR 


DEV-NOT-FOUND 


INCOMPfiTIBLE 


;utilizzato per muovere il puntatore ai record 
;lun 90 la tavola indice in modo che arrivi al 
; termine della lista 

9 jQuesto errore si verifica quando si tenta di 

jinserire/appendere un ulteriore record a un file 
jche già' contiene il massimo numero di record 
^possibile (attualmente 127) 

10 jQuesto errore si verifica quando una routine 
^realizzata per gestire una particolare struttu- 
jra di file viene impiegata per agire su file con 
jstruttura diversa 

11 jQuesto errore si verifica durante la chiamata a 
jReadFile, quando nel corso del caricamento il 
jnumero di byte del file oltrepassa il massimo 
jspecificato all'atto della chiamata alla 

; routine 

12 ;Questa chiamata d'errore e' stata realizzata per 
jpermettere al programmatore di impiegare un box 
;di dialogo durante accessi al disco di basso 
jlivello, e di utilizzare l'icona CfìNCEL per 
;bloccare inmaniera distruttiva la procedura,Per 
jesempioj se l'applicazione osserva che e' stata 
jselezionata l'icona CflNCELj deve caricare in x il 
jcodice dell'errore CflNCEL-ERR prima di restitui- 
;re il controllo (la convenzione per gli errori da 
jdisco e' che siano restituiti in x prima del' 
^ritorno). La routine di livello superiore e' 
;cosi' in grado di determinare che il codice 
;d'errore restituito non corrisponde in realta' a 
jun errore avvenuto durante l'accesso al disco, ma 
jalla richiesta dell'utente di sospendere 

j1'operazione 

13 )Questo errore si verifica quando la routine 
;"Listen" del Kernel del C-64 viene impiegata 
;per aprire un canale di comunicazione con un 
;dispositivo sul bus seriale, e il dispositivo non 
;e' attivo 

14 ;0uesto errore si verifica quando vengono 

; richiesti il caricamento e l'esecuzione di un 
; programma che non può' essere eseguito con il 
jmodo grafico correntemente attivato da GEOS 128 
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HDR-NOT-THERE 


$20 

jQuesto errore si verifica quando il blocco File 
;Header di un file non e' presente 

NO-SYNC 


$21 

jQuesto errore si verifica quando il drive non 
; riesce a trovare sul disco il marcatore di 
;sincronismo. In genere la causa e' una di queste: 
;il disco non e' inserito nel drive, il ineccanisao 
;di chiusura e' aperto, il disco non e' formattato 

DBLK-NOT-THERE 

= 

$22 

;I1 blocco di dati non e' presente nel settore 
ì richiesto 

DflT-CHKSUH-ERR 


$22 

jll blocco su disco non verifica il controllo di 
jsomma (checksum). In questo il caso il blocco e' 
;stato memorizzato male 

WR-UER-ERR 


t25 

jLa verifica dei dati appena trasferiti in un 
;settore del disco non ha successo, Normalmente 
jaccade se il blocco e' alterato 

WR-PR-ON 


$26 

jQuesto errore si verifica quando si tenta di 
jscrivere su un disco munito di fascetta 
jprotettiva 

HDR-CHKSUH-ERR 


$27 

;I1 blocco header non verifica il controllo di 
jsomma (checksum) 

DSK-IDJIISMflT 


$29 

jLa ID letta da disco non corrisponde alla IO 
jinterna prevista. Normalmente si verifica questo 
jerrore se: viene cambiato il disco senza che venga 
jinoltrato il comando NeuDisk, Tutente commette 
jun errore nella manipolazione dei dischi da 
jinserire 

BYTE-DEC-ERR 


$2E 

jErrore nella codificazione del flusso di dati 
jproveniente dal disco 

OOS-MISIIflTCH 

— 

$73 

jL'identificatore del DOS del drive non 
jcorrisponde 


; Box di dialogo 


DEF-DB-POS 


$80 

jFlag per indicare 
jdel BD di default 

la posizione e le dimensioni 
(gestito quindi dal Kernel). 

SET-DB-POS 


$00 

jFlag per indicare 
jvedere a gestire 
jposizione. 

che l'applicazione deve prev¬ 
ie dimensioni del 6D e la sua 
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jTavola dei conandì per i box di dialogo (BO) 

jLe icone di sistena disponibili per i BD. Queste icone sono predefinite e facilitano 
;la realizzazione dei BO. Nella naggior parte dei casi causano la chiusura dei BD e la 
jrestituzione del controllo all'applicazione. Il nupero dell'icona selezionata viene 
;passato all'applicazione tramite la variabile sgsDBOata 

jNota: in tutti i comandi per i BD; le posizioni specificate (tramite le coordinate x e g) 
jdevono riferirsi all'angolo superiore sinistro del BO, e non dello schermo. 
jNormalmente questi offset sono in pixel, ma in alcuni casi la coordinata x può' essere 
; richiesta in bgte (per esempio nel caso delle icone) 


;Per tutti i comandi delle icone di sistema, i due byte che seguono indicano 
jrispettivamente la coordinata x in byte e la coordinata y in pixel 


OK 

s 

1 

{Icona di sistema per 

i BDi 

“OK» 

CRNCEL 

= 

2 

{Icona di sistema per 

i BDi 

"CRNCEL" 

YES 

- 

3 

{Icona di sistema per 

i BD; 

"YES" 

NO 

= 

4 

{Icona di sistema per 

i BD; 

"NO" 

OPEN 

9B 

5 

{Icona di sistema per 

i BO; 

"OPEN" 

DISK 

- 

S 

{Icona di sistema per 

i BD; 

"DISK" 

FUTUREl 

SS 

7 

{Riservata per future 

icone 

di sistema 

FUTURES 

= 

8 

{Riservata per future 

icone 

di sistema 

FUTURES 

= 

9 

{Riservata per future 

icone 

di sistema 

FUTURE4 


10 

{Riservata per future 

icone 

di sistema 


jflltri comandi per i box di dialogo 


DBTXTSTR 


OBVflRSTR 


OBGETSTRING 


11 jComando per visualizzare un stringa RSCII. Il 
jcomando dev'essere seguito dall'indirizzo della 
astringa a terminazione nulla e dalla posizione 
;aH'interno del BD 

12 ;Comando per la visulizzazione di stringhe 
;diverse. Dev'essere seguito dall'indirizzo di 
;un registro in pagina 8. Questo registro può' di 
jvolta in volta contenere l'indirizzo di una 
,'diversa stringa da visualizzare. Segue 

; 1'indicazione della posizione all'interno 
idei BD 

13 iRccetta una stringa RSCII dall'utente e la 
{memorizza in un buffer. Il comando e' seguito 
{dalla posizione dell'eco della stringa sullo 
{Schermo, dall'indirizzo del registro che 
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DBSYSOPV 

DBGRPHSTR 

DBGETFILES 


DBOPVEC 

DBUSRICON 

DB-USR-ROUT 
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;contiene il puntatore al buffer da utilizzare e 
jdal nassiiDO numero di caratteri accettabili 

14 ;11 comando non ba parametri, Qualsiasi pressione 
;del pulsante del mouse su una zona dello schermo 
jche non e' un'icona, causa la chiusura del BD 

;e il ritorno all'applicazione 

15 ;Questo comando manda in esecuzione una stringa 
; grafica. Il comando dev'essere seguito da un 
;puntatore alla stringa grafica in memoria. 

16 ;Questo comando richiede alla struttura di gestio- 
jne dei BD di visualizzare, nella parte sinistra 
;della finestra, un box con la lista di tutti i file 
jdel tipo specificato presenti sul disco. Se il 
;disco contiene un numero di file del tipo indicato 
;maggiore di quello che trova posto nel box, 
jappaiono nella parte inferiore due frecce che 
;possono comandare lo scroll verticale della 
;lista. Il comando dev'essere seguito dalla 
jposizione dell'angolo superiore del box. La rou¬ 
tine di gestione del comando si aspetta che in 
;r7L sia memorizzato il puntatore al tipo di file, 
;in r5 il puntatore al buffer entro il quale 
^memorizzare la lista dei nomi di file, e rlBL 
jcontenga il puntatore al nome permanente 
;utilizzato come seconda chiave di ricerca. Se 
jquesta ulteriore specificazione non e' 
jrichiesta, rlBL dev'essere azzerato 

17 ;L'indirizzo che segue il comando indica il 
;vettore otherPressVec impostato 

;daH'applicazione. Impartendo questo comando, 

;se l'utente preme il pulsante del mouse in 
;una zona che non sia un'icona o un menu, 

;GE0S esegue la routine puntata dal vettore 
jotherPressVec 

18 ;I1 comando permette all'applicazione di definire 
jun'icona non standard da inserire nella struttu- 
;ra delle icone del BD. La uord che segue il 
jcomando individua la tavola di definizione 
;deiricona. Segue la posizione dell'icona 

jairinterno del BD 

19 ;Questo comando definisce una routine, creata 
;daH'applicazione, che GEOS esegue dopo aver 
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;visualizz3to il BD. L'indirizzo della routine 
; viene subito dopo il comando 


;Le seguenti costanti sono gli offset da utilizzare all'interno delle tavola di 
;definizione dei BO per indicare i parametri significativi 


OFF-DB-FORtI 

OFF-DB-TOP 

OFF-OB-BOT 

OFFJIB-LEFT 

0FFJ3B-RIGHT 

OFF-OB-ISTCMO 


«flX-DB-ICONS 


0 ^Offset all'indicatore della forma (per 

;eseapi 0 j con ombra o meno). 

1 ;Offset alla posizione del lato superiore del BO 

2 ;Offset alla posizione del lato inferiore del BD 

3 ^Offset alla posizione del lato sinistro del BD 

5 jOffset alla posizione del lato destro del BD 

7 jOffset al primo comando della tavola di 
^definizione del BD quando e' l'applicazione a 
;definirne le dimensioni e la posizione. 

; La costante che segue stabilisce quante icone 
jpossono essere definite all'interno della 
jtavola di definizione. Questa costante viene 
;utilizzata per allocare lo spazio in Rflh per 
jle icone del BD 

8 ;Numero massimo di icone in un BD 


;La costante che segue viene utilizzata per specificare gli offset x e y dal BD per 
; visualizzare l'ombra, se e' richiesta. Questa costante dev'essere un multiplo di 8, per 
^evitare una non compatibilita' con future versioni a colori. 


DB-SHflD-OFFSET 


8 jOffset dai bordi del BD per visualizzare l'ombra 


jLe costanti che seguono individuano le dimensioni delle icone standard per i BD messe 
;a disposizione da GEOS. 


SYSDBIJIIDTH = 6 jLarghezza in byte dell'icona 

SYSDBI-HEIGHT = 16 jflltezza in pixel dell'icona 

;Le seguenti costanti sono utilizzate per gestire il comando BDGETFILES 

DB-F-BOX-WIDTH = 124 ;Larghezza in pixel del box nel quale appaiono 

ji nomi dei file del tipo specificato 
;fìltezza in pixel del box nel quale appaiono 
,‘i nomi dei file del tipo specificato 


DB-F-BOX-HEIGHT 


88 
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DB-F-SCR-ICN-X-OFF 


7 

;Offset in byte dalla linea verticale 
individuata dal lato sinistro del box 
idei file, alle icone per lo scroll 

DB-F-SCR-ICN-HEIGHT 

a 

14 

;flltezza dell'icona di scroll dal lato 
inferiore del box 

DBF-LINE-HEIGHT 


le 

;fìltezza, dal lato inferiore del box, che 
individua la posizione della linea di separazio* 
;ne fra l'area delle icone e quella per i nomi 
;dei file 

nflX-DB-FILES 


15 

;NuMero massimo di file i cui nomi possono 
;essere inseriti nel buffer 

DB-FSCR-ICNJJIDTH 

m 

3 

,‘Larghezza, in byte, dell'icona utilizzata 
,'per lo scroll dei nomi 

DB-FSCR-ICK-HEIGHT 


12 

;Rltezza, in pixel, dell'icona utilizzata per 
;lo scroll dei nomi 

DBF-YJ.1NE.0FF 

- 

14 

{Offset y fra i diversi nomi dei file 

DB-TXT-BflSE-OFF 


9 

{Offset, dal lato superiore dello spazio 
{rettangolo, della posizione della linea di base 
{per il testo che individua il nome del file 


jRltre costanti per i box di dialo 90 

jQueste costanti definiscono le dimensioni e la posizione del box di dialogo standard, 
je altre posizioni standard per visualizzare testi e icone aH'interno di un BD 


DEF-DB-TOP 

- 

32 

{Coordinata y del lato superiore del 60 di default 

DEF-DB-BOT 

- 

127 

{Coordinata y del lato inferiore del BO di default 

DEFJJB-LEFT 

- 

£4 

{Coordinata x del lato sinistro del BD di default 

DEF-DB-RIGHT 

» 

255 

{Coordinata x del lato destro del BD di default 

TXT-LN-X 

am 

16 

{Coordinata x standard per i testi 

TXT-LN-l.Y 

- 

16 

{Offset verticali standard per le linee di testo 

TXT-LN-2.Y 

- 

32 


TXT-LN-3-Y 

- 

48 


TXT-LN.4-Y 

- 

64 


TXT-LN-5-Y 

•= 

80 


DBI-X-0 

- 

1 

{Offset in byte alla coordinata x dell'icona 
{Standard di sinistra 

OBI-X-1 

= 

9 

{Offset in byte alla coordinata x dell'icona 
{Standard di centro 

DBI-X-2 

am 

17 

{Offset in byte alla coordinata x dell'icona 
{Standard di destra 
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DBI-YJ 

* 

8 

DBI-Y-1 

- 

40 

DBI-Y-2 


72 


jOffset in pixel alla coordinata y dell'icona 
;standard in alto 

^Offset in pixel alla coordinata y dell'icona 
; standard in cent ro 

jOffset in pixel alla coordinata y dell'icona 
; standard in basso 


; tmtttmttttmmmttmtmummttmmntmmmmmmtmmmttmmm 

1 Microprocessore VIC 

j tmttttmmmttnmmmmmttmmttntttmmmmtmmtmmtmmmm 


CRBRNKe 

GRBRNKl 

GRBRNK2 

GRBRHK3 

SKIPFLRG 

«OUSE-SPRNUM 

VIC.YP0SJ3FF 

VICJtPOS-OFF 


RLRHMRSK 


’/Al Mndica che il banco da 16K visto dal VIC e' il 

;prÌBo: $6000 - $3FFF 

XIB ; Indica che il banco da 16K visto dal VIC e' il 

; secondo! $4000 - $7FFF 

^01 ; Indica che il banco da 1€K visto dal VIC e' il 

jterzo! $8000 - $BFFF 

^00 jIndica che il banco da 16K visto dal VIC e' il 

jquarto! $C000 - $FFFF 

$RR jFlag per indicare che il particolare dato 

;airinterno della tavola di'inizializzazione 
jdel Vie dev'essere ignorato 

0 jNunero dello sprite utilizzato per il nouse 

50 jOffset verticale per collocare uno sprite 

;harduare in alto sullo scherno. Questo valore 
jviene utilizzato per convertire le coordinate 
;GEOS degli sprite in coordinate hardware 

24 jOffset orizzontale per collocare uno sprite 

;harduare in alto sullo scherno. Questo valore 
jviene utilizzato per convertire le coordinate 
jGEOS degli sprite in coordinate hardware 

i!00000i00 jMaschera per il bit d'allarne nel registro di 
jcontrollo degli interrupt per il VIC 
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; tututiutuututtitttutttttttuttttttttuttttwiutttttttttttttuttttttttuttttttttttt 
; Bit di salvataggio dello scherno per gli accessori da scrivania 

; ttnnuntuutuutuuuuuuuuuttittuuuuuittttuuttuutnntuuuuututt 


FG-SflVE 

CLR-SflVE 


/^IBBBBBBB ;Salva e ripristina la parte di scherno 
jinteressata 

^01000000 ;Salva e ripristina le infornazioni del colore 
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GEOS GLOBALI 


nnttttttutttnnnuunnntnttnntutttutnuttttnnnunuununuutunuu 

geosMenorylIap 

Questo file contiene una descrizione della nappa di Memoria di GEOS e delle allocazioni 
in pagina 0 e in RRM sistema delle variabili utilizzate dal sistema operativo 
In questo file sono richiamate molte costanti definite neH'appendice fì 
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Mappa di memoria di GEOS 


Numero 

indirizzi 

Descrizione 

di byte 

del range 


Decimale 

Esadecimaie 


1 

0000 

Registro direzione dati del 6510 

1 

0001 

Registro di I/O del 6510 

Ile 

0002 - 006F 

R8H in pagina 0 per GEOS e per le applicazioni 

16 

0070 - 007F 

R8H in pagina 0 solo per le applicazioni, 



registri a2-a9 

11 

0080 • 0088 

R8n in pagina 0 per Kernel C-64 e Basic 

5 

008B - 008F 

R8I1 in pagina 0 per i disk driver di GEOS 

107 

0090 • 00Ffì 

R8I1 in pagina 0 utilizzata dal Kernel C-64 



e dal Basic 

4 

00FB - 00FE 

R88 in pagina 0 solo per le applicazioni, 



registri a0-al 

1 

00FF 

Utilizzata dal Kernel del C-64 e dal Basic 

256 

0100 - 01FF 

Stack del 6510 

89 

0200 - 0258 

RRM a disposizione delle applicazioni 



per le variabili teaporanee 

219 

0259 - 0333 

R8n utilizzata dal Kernel del C-64 

204 

0334 - 03FF 

ROM per le applicazioni, spazio prograiaa 

23552 

0400 - 5FFF 

R8n per i codici delle applicazioni 

8000 

6000 - 7F3F 

R8n dello scherao nascosto 

192 

7F40 - 7FFF 

R8n per le applicazioni 

2560 

8000 - 89FF 

Buffer e variabili per GEOS 

512 

8800 - 8BFF 

Dati dei disegni degli sprite 

1000 

8C00 - 8FE7 

natrice video dei colori 

16 

8FE8 - 8FF7 

R8n per GEOS 

8 

8FF8 - 8FFF 

Puntatori agli sprite 

4096 

9000 - 9FFF 

Codici di GEOS 

8000 

8000 - BF3F 

Scherao principale o ROM del Basic 

192 

BF40 - BFFF 

Tavole di GEOS o ROn del Basic 

4096 

C000 - CFFF 

4K Kernel di GEOS, seapre residente 

3584 

D000 - DOFF 

4K Kernel di GEOS o spazio di I/O 

512 

OE00 - DFFF 

Nessuna RRN/ROH, spazio per REU 

7808 

E000 - FE7F 

8K Kernel di GEOS o Kernel C-64 

378 

FE80 - FFF9 

Driver di input o Kernel del C-64 

6 

FFF8 - FFFF 

Vettori di NHI, IRQ e Reset del 6510 
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jLocazioni di leioria del C-€4 


CPU-DOR 

as 

tem 

;Registro direzione dati del 6510 

CPUJfiTfl 

- 

leeei 

{Registro di I/O del 6510 

STATUS 

- 

*0090 

{Registro di stato del 0-64 

curDevice 

- 

I00BA 

{Oispositivo seriale corrente 

irqvec 

- 

*0314 

{Vettore IRQ (word) 

brkvec 

- 

*0316 

{Vettore BRK (word) 

nmivec 

- 

*0318 

{Vettore NMI (word) 

kernelVectors 

- 

*031A 

{Locazione dei vettori del Kernel 

vicbase 

- 

*0000 

{Indirizzo base dell'interfaccia video 

sidbase 

» 

*0400 

{Indirizzo base dell'interfaccia ausicele 

ctab 

- 

*0800 

{Mappa dei colori 

cialbase 

» 

*OC00 

{Priaa interfaccia di coaunicazione (CIA) 

cia2base 

- 

*0000 

{Seconda interfaccia di coaunicazione (CIA) 

EXP-BASE 


*OF00 

{Indirizzo base della porta di coaunicazione con 
{l'espansione RAM 

kernellìist 
, ifdef 

• if 

C-128 

C-128 

*F036 

{Lista di vettori per il Kernel C-64 

nau 

m 

*0500 


VOC 

.endif 

.endif 


*0600 


;La variabile 

che segue viene 

' di solito definita solo se C*128 » 1. E' utile guando 

;un prograaaa 

per il C-64 deve interagire 

con il Kernel del C-128 

config 

- 

*FF00 

{Indirizzo del registro di configurazione 
{nel C-128 

; Indirizzi delle routine del 

Kernel del C- 

64, Per aaggiori inforaazioni sul loro iapiego. 

jconsultare il 

aanuale pubblicato dalla Coaaodore Italiana, "Coaaodore 64, 

;Guida di riferiaento per il 

prograaaatore 

li 

Acptr 

. 

*FFA5 

{Accetta un carattere dal bus seriale 

Chkin 

- 

*FFC6 

{Apre un canale di input associato al file logico 

Chkout 

- 

*FFC9 

{Apre un canale di output associato al file logico 

Chrin 

- 

*FFCF 

{Preleva un bgte dal canale seriale 

Chrout 

- 

*FF02 

{Trasaette un byte attraverso il canale seriale 

Ciout 

- 

*FFA8 

{Trasaette un byte sul bus seriale 

Cint 

m 

*FF81 

{Inizializza lo scherao (viene utilizzata per 
{restituire il controllo al Basic) 
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Clan 


$FFE7 

jChiude tutti i file aperti 

Close 

= 

IFFC3 

{Chiude il file logico passato nell'accumulatore 

ClrChn 


$FFCC 

{Cancella i canali di I/O 

Getin 


$FFE4 

{Preleva un carattere dalla scansione della tastiera 
{(non viene usata) 

lobase 

« 

$FFF3 

{Restituisce l'indirizzo dello spazio di I/O in 
{memoria (non viene usata) 

loinit 

= 

$FF84 

{Inizializza tutti i dispositivi di I/O 

Listen 


$FFB1 

{Ordina a un dispositivo di mettersi in ascolto sul bus 
{seriale 

Load 

= 

$FFD5 

{Carica un file da un dispositivo di input e lo 
{memorizza 

Meffibot 

= 

$FF9C 

{Imposta 0 legge l'inizio della memoria Basic 

Memtop 


♦FF99 

{Imposta 0 legge la fine della memoria Basic 

Open 

= 

$FFC0 

{Apre un file logico 

Restor 


$FF8fl 

{Ripristina i vettori di sistema e di interrupt 
{copiandoli dalla tavola a $FD30 e memorizzandoli a 
{$0314 

Save 

= 

$FFD8 

{Salva una particolare area di memoria sul 
{dispositivo di output 

Scnkey 

= 

$FF9F 

{Routine di scansione della tastiera 

Second 

a= 

$FF93 

{Trasmette l'indirizzo secondario al dispositivo in 
{ascolto 

Setlfs 

= 

IFFBfl 

{Prepara i parametri di un file logico 

SetfflS 9 

- 

$FF90 

{Gestisce i messaggi del Kernel 

Setnan 

ae 

tFFBO 

{Imposta il nome del file 

Tksa 

* 

$FF96 

{Trasmette un indirizzo secondario al dispositivo in 
{trasmissione 

Unlsn 

* 

IFFfiE 

{Trasmette sul bus seriale il comando di cessare 
{l'ascolto 

Untlk 

■* 

$FFft8 

{Trasmette sul bus seriale il comando di cessare la 
{trasmissione 

;Definizioni degli 

spazi di 

memoria utilizzati da GEOS 

SYSTEM-RflII 

az 

10400 

{Inizio della RRI1 di sistema 

flPP-RflM 

as 

$0400 

{Inizio dello spazio per le applicazioni 

BflCK-SCR-BflSE 

= 

16000 

{Inizio dello schermo nascosto 

PRINTBflSE 

ss 

$7900 

{Indirizzo al quale devono allocarsi i driver di 
{Stampa 

flPP.yflR 

K 

$7F40 

{Spazio per le variabili delle applicazioni 

OS-VflRS 

« 

$8000 

{Inizio dello spazio per le variabili di sistema 
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SPRITE-PICS 

= $8fl00 

ilnizio dei disegni degli sprite 

COLOR-MflTRIX 

= $8C00 

;Matrice video dei colori 

DlSK-BflSE 

= $9000 

iIndirizzo base per i disk driver 

SCREEN-BflSE 

- $fì000 

; Inizio dello schermo principale 

OS-ROM 

= $C000 

jInizio dei codici del sistema operativo 

OS-JUMPTflB 

= $C100 

{Inizio della tavola contenente gli entry point per 
;le routine di GEOS 

MOUSE-JHP 

= $FE80 

{Inizio della Jump table del driver di input 

.ifndef 

C-128 


MOUSE-BflSE 

= $FE80 

{Inizio in memoria del driver di input 

END-MOUSE 

= $FFFft 


• elif 

C-128 


MOUSE-BflSE 

» $FE80 

{Inizio in memoria del driver di input 

END-MOUSE 

.else 

= $FFFfl 


MOUSE-BflSE 

= $FD00 

{Inizio in memoria del driver di input 

END-MOUSE 

.endif 

- $FE80 


; Locazioni a 

pagina $C000 che 

caratterizzano il Kernel correntemente installato 

bootName 

- $C006 

{Inizio della stringa "GEOS BOOT" 

version 

= $C00F 

{Byte che indica la versione di GEOS 

nationalitg 

= $C010 

{Byte che indica la nazionalità' della versione 

sgsFlgCopg 

= $C012 

{Copia della variabile sysRflMFlg che viene salvata 
{quando il controllo passa al Basic 

dateCopg 

= $C018 

{Data della copia in anno, mese, giorno 


;Entry point (punti d'ingresso) àlTinterno dei disk driver 

;Questi indirizzi sono validi solo per disk drive diversi dal 1541 con GEOS 64, e per il driver 
idei 1541 disponibile in ambiente GEOS 128i 


GetlstDirEntry 

= $9030 

{Restituisce il primo File Entry in directory 

GetNxtDirEntry 

- $9033 

{Restituisce il successivo File Entry in directory 

flllocateBlock 

= $9048 

{Alloca un particolare blocco 

ReadLink 

= $9048 

{E' simile a ReadBlock, ma restituisce solo i primi due 



{byte del blocco 


.ifdef 

,if 

Jmplndx 


C-128 

C-128 

= $9080 indirizzo di una routine necessaria al Kernel del 

jC-128 
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.endìf 

.endif 


; Indirizzi degli entry point all'interno del driver di stampa 


InitForPrint 

ac 

PRINTBflSE 

;17900 

indirizzo 

di InitForPrint 



StartPrint 


PRINTBflSE+3 

j$7903 

indirizzo 

di StartPrint 



PrintBuffer 

= 

PRINTBflSE+6 

j17906 

indirizzo 

di PrintBuffer 



StopPrint 

= 

PRINTBftSE+9 

; 17909 

indirizzo 

di StopPrint 



GetDimensions 

= 

PRINTBflSE+12 

j$790C 

indirizzo 

di CetDimensions 



PrintflSCII 

= 

PRINTBflSE+15 

;$790F 

indirizzo 

di PrintftSCII 



StartflSCII 

= 

PRINTBftSE+18 

j$7912 

indirizzo 

di StartRSCII 



SetNLQ 

ss 

PRINTBftSE+21 

j»7915 

indirizzo 

di SetNLQ 



jIndirizzi degli entry point nel driver 

di input 




Initliouse 


«OUSE-JflP 

;$FE80 

indirizzo 

di InitHouse 



SlouKouse 

= 

MOUSE-JHP+3 

;$FE83 

indirizzo 

di SlowNouse 



UpdateHouse 

•= 

MOUSE-JMP-l-6 

j$FE86 

indirizzo 

di UpdateHouse 



SetMouse 

- 

I10USE-JI1P+9 

;»FE89 

indirizzo 

di SetHouse (vale solo 

per i 




;driver 

del C-128, DJD 2-9-87) 



;Indirizzi di 

particolari dati per gli 

sprite 





sprBpic 


SPRITE-PICS 

;$8B00 

indirizzo 

dei dati grafici 

dello 

sprite 

sprlpic 

= 

spr0pic+64 

;$8fl40 

indirizzo 

dei dati grafici 

dello 

sprite 

spr2pic 

= 

sprlpic+64 

j$8R80 

indirizzo 

dei dati grafici 

dello 

sprite 

spr3pic 

= 

spr2pic+64 

j$8nC0 

indirizzo 

dei dati grafici 

dello 

sprite 

spr4pic 

= 

spr3pic+64 

;$8B00 

indirizzo 

dei dati grafici 

dello 

sprite 

sprSpic 

= 

spr4pic+64 

;$8B40 

indirizzo 

dei dati grafici 

dello 

sprite 

spr6pic 

= 

spr5pic+64 

;$8B80 

indirizzo 

dei dati grafici 

dello 

sprite 

spr7pic 

= 

spr6pic+64 

j$8BC0 

indirizzo 

dei dati grafici 

dello 

sprite 

NMI-VECTOR 

= 

»FFFfl 

;Locazione del vettore NKI 



RESET-VECTOR 

= 

$FFFC 

;Locazione del vettore RESET 



IRO-VECTOR 

* 

IFFFE 

^Locazione del vettore IRQ 












APPENDICE B: VARIABILI GEOS GLOBALI 


517 


1 mmtmmtmmmtmmmumtmmmmmmmmmmmmttmmtmm 

ì Definizioni e variabili del chip 9 rafico VIC II 


■obBxpos 

= 

vicbase 

;$D000 coordinate x e y di ogni sprite 

■obBypos 

- 

loeei 


Boblxpos 

= 

$0002 


Boblypos 

al 

$0003 


aobSxpos 

= 

$0004 


Bob2ypos 

- 

$0005 


Bob3xpos 

- 

$0006 


Bob3ypos 

= 

$0007 


Bob4xpos 

s 

$0008 


Boblypos 

K 

$0009 


BobSxpos 

= 

$D00fì 


BobSypos 

= 

$0008 


BobSxpos 

= 

$D00C 


BobSypos 

= 

$0000 


Bob7xpos 

- 

$D00E 


BobZypos 

- 

$D00F 


Bsbxpos 

= 

$0010 

;Bit 9 della coordinata x di ogni sprite 

grcntrll 

= 

$0011 

jRegistro di controllo grafico 

st-ecB 

» 

$40 

;6it definiti per essere utilizzati con il 

St-bBB 

« 

$20 

;registro grcntrll 

st-den 

S 

$10 


st-25rou 

= 

$08 


rasreg 


$0012 

;Registro di controllo del raster 

Ipxpos 

- 

$0013 

;Coordinata x della penna ottica 

Ipypos 

» 

$0014 

;Coordinata y della penna ottica 

Bobenble 

aa 

$0015 

;Controllo abilitazione degli sprite 

grcntrl2 

= 

$0016 

jSecondo registro di controllo grafico 

St_BCffi 


$10 

;Bit definiti per essere iapiegati con il 

st-40col 

« 

$08 

;registro grcntrll 

Boby2 

3S 

$0017 

;Ingrandiaento verticale dello sprite 
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grnenptr 

ts 

»D018 

jPuntatori grafici in memoria, per esempio 
jl'inizio della matrice di schermo e della ROM 
jearatteri 

grirq 

= 

$0019 

;Registro di controllo degli interrupt grafici 

grirqen 

ias 

$D01fl 

jRegistro di abilitazione degli interrupt grafici 

st-rasen 

s 

$01 

j8it per abilitare l'interrupt di raster 
; in grimen 

nobprior 

= 

$0018 

;Priorita' degli sprite con lo sfondo 

mobificni 

= 

$O01C 

jOpzione multicolor per gli sprite 

■iiobx2 

= 

$0010 

jIngrandimento orizzontale dello sprite 

mobinobcol 

= 

$O01E 

;Registro di collisione fra sprite 

mobbakcol 

= 

$O01F 

jRegistro di collisione fra sprite e sfondo 

extclr 

= 

$0020 

jColore del bordo 

backlrb 

= 

$0021 

jColore 0 di sfondo 

backlrl 

= 

$0022 

jColore 1 di sfondo 

backlrZ 

= 

$0023 

jColore 2 di sfondo 

backlr3 

= 

$0024 

jColore 3 di sfondo 

menici r0 

= 

$0025 

jColore 0 degli sprite in multicolor 

mcmclrl 

« 

$0026 

jColore 1 degli sprite in multicolor 

mob0clr 

= 

$0027 

jColori dello sprite 

moblclr 

= 

$0028 

jColori dello sprite 

mob2clr 


$0029 

jColori dello sprite 

mob3clr 


$O02fl 

jColori dello sprite 

moblclr 

= 

$0028 

jColori dello sprite 

mobSclr 

se 

$O02C 

jColori dello sprite 

mob6clr 

= 

$0020 

jColori dello sprite 

mobZclr 

= 

$O02E 

jColori dello sprite 

keyreg 

= 

$D02F 

jRegistro del C-128 di controllo della tastiera 

clkreg 

■ 

$0030 

jRegistro del C-128 per la frequenza di clock 
j<l 0 2 MHz) 

obj0Pointer 


COLOR-«flTRIX+$03F8 

jPuntatori ai disegni degli sprite in RAM 

objlPointer 

= 

$8FF9 


obj2Pointer 

= 

$8FFfl 


obj3Pointer 

= 

$8FF8 


objlPointer 

= 

$8FFC 


objSPointer 

= 

$8FF0 


objSPointer 

s 

$8FFE 


objZPointer 

= 

$8FFF 
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; mtmmmmmmmmmmmmmmmmmmmmmtmtmmmmmm 

; Definizioni e variabili per il chip SID <6581) generatore di suoni 

; uttimttttttttuttttttnttnttttttittttttttttttiittttutttuiumiuntttttntttnum 


vlfreqlo 

= 

sidbase 

j$O400, registri solo in scrittura 

vlfreqhi 

ae 

$0401 


vlpulo 

st 

10402 


vlpwhi 

= 

$0403 


vlcntrl 

= 

$0404 


vlattdec 

= 

$0405 


visusrei 

= 

$0406 


v2freqlo 

= 

$0407 


v2freqhi 

- 

$0408 


v2pulo 

= 

$0409 


v2puhi 

- 

$0408 


v2cntrl 

= 

$0408 


v2attdec 

= 

$D40C 


v2susrel 

= 

$0400 


v3freqlo 

= 

$D40E 


v3freqhi 

= 

$O40F 


v3pulo 

a; 

$0410 


v3puhi 

= 

$0411 


v3cntrl 

= 

$0412 


v3attdec 

= 

$0413 


v3susrel 

= 

$0414 


fclo 

= 

$0415 


fchi 

= 

$0416 


resfili 

= 

$0417 


fflodevol 

= 

$0418 


potx 

= 

$0419 

jRegistri solo in lettura 

poty 

= 

$0418 


osc3rand 

= 

$0418 


env3 


$D41C 
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; ttmmmmumnmttmiumimnmtntmtmmtuimmmmmmmmmt 

; Definizioni 

e variabili 

per il chip CIR (6528) interfaccia di coiunicazione 

; nntnuunnutnnnutuutnnnntutttnntinttttnttutnttttntttnnnnttntt 

cialpra 


cialbase 

;$DC00 Re 9 istro dati 'a' del cial 

cialprb 

= 

$DC01 

jRegistro dati 'b' del cial 

cialddra 

SS 

$OC02 

jRegistro direzione dati 'a' del cial 

cialddrb 

= 

$DC03 

;Registro direzione dati 'b' del cial 

cialtalo 

= 

$OC04 

jRegistro basso del titer 'a' del cial 

cialtahi 

ss 

$DC05 

jRegistro alto del tiier 'a' del cial 

cial lo 

- 

fDC0e 

jRegistro basso del tiaer 'b' del cial 

cial hi 

s 

♦DC07 

jRegistro alto del tiaer 'b' del cial 

ciallodl01hs 

= 

$DC08 

jRegistro dei deciai di secondo del cial 

cialtodsec 

ss 

tOC09 

jRegistro dei secondi del cial 

cialtodnin 

ss 

$DC0R 

jRegistro dei ninuti del cial 

cialtodhr 

= 

IOC0B 

jRegistro delle ore RK/PH del cial 

cialsdr 

s 

IDC0C 

jRegistro dati seriali dei cial 

cialicr 

= 

»DC0D 

jRegistro di controllo degli interrupt del cial 

cialcra 

= 

JDC0E 

jRegistro 'a' di controllo del cial 

cialcrb 

= 

$DC0F 

jRegistro 'b' di controllo del cial 

cia2pra 

B 

cia2base 

j$OD00 Registro dati 'a' del cia2 

cia2prb 

ss 

$DD01 

jRegistro dati 'b' del cia2 

cia2ddra 

= 

$DD02 

jRegistro direzione dati 'a' del cia2 

cia2ddrb 

= 

$DD03 

jRegistro direzione dati 'b' del cia2 

cia2talo 

B 

$DD04 

jRegistro basso del tiaer 'a' del cia2 

cia2tahi 

SS 

iDDes 

jRegistro alto del tiaer 'a' del cia2 

cia2 lo 

= 

$DD0e 

jRegistro basso del tiaer 'b' del cia2 

cia2 hi 

» 

IDD07 

jRegistro alto del tiaer 'b' del cia2 

cia2todl0ths 

B 

IDD08 

jRegistro dei deciai di secondo del cia2 

cia2todsec 

= 

$DD09 

jRegistro dei secondi del cia2 

cia2todnin 

= 

$DD0R 

jRegistro dei ainuti del cia2 

cia2todhr 

= 

$DD0B 

jRegistro delle ore RH/PH del cia2 

cia2sdr 

* 

$DD0C 

jRegistro dati seriali del cia2 

cia2icr 

= 

IDD0D 

jRegistro di controllo degli interrupt del cia2 

cia2cra 

= 

$DD0E 

jRegistro 'a' di controllo del cia2 

cia2crb 

SS 

$DD0F 

jRegistro 'b' di controllo del cia2 
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jPagina 0 

;90-01 Registri di I/O del 6510 

;02-33 Pseudoregistri da due byte chiaaati r0*rlS. Vengono utilizzati per 

spassare parametri fra le applicazioni e il Kernel di GEOS, e aeaorizzare 
;teaporaneaaente i dati. Questi registri vengono salvati all'inizio 
idi una procedura di interrupt (InterruptHain) in lodo che sia HainLoop 
;(o l'applicazione) sia InterruptHain possano utilizzare le stesse 
iroutine ’conteaporaneaMnte* 

,'34-6F Variabili globali del sisteaa operativo 

;70-7F Registri riservati per le applicazioni a2-a9 

j80-Ffl Spazio correnteaente riservato al Kernel del C-64 

jFB'FE Registri riservati per le applicazioni aO*al. Questo spazio di aeaoria e' 

;coapletaaente disponibile e non viene alterato da operazioni di sisteaa 
jFF Utilizzato dal Kernel del C-64 e dal Basic 


jPseudoregistri 

.zsec 

100 

zpage: 

.block 2 

;Registri del 6510 

r0i 

.block 2 


r0L 

- 

$02 

r0H 

- 

$03 

rii 

.block 2 


rlL 

- 

$04 

rlH 

- 

$05 

r2! 

.block 2 


r2L- 

- 

$06 

r2H 

- 

$07 

r3! 

.block 2 


r3L 

- 

$08 

r3H 

- 

$09 

r4! 

.block 2 


r4L 

- 

$08 

r4H 

m 

$06 

rSi 

.block 2 


r5L 

- 

$0C 

r5H 

m 

$0D 
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r6; 

.block 2 


r6L 

» 

$0E 

r6H 

ss 

$0F 

r7i 

.block 2 


r7L 

= 

$10 

r7H 

= 

$11 

r8: 

.block 2 


rSL 

= 

$12 

rSH 

= 

$13 

r9i 

.block 2 


rSL 

= 

$14 

rSH 

- 

$15 

rl0! 

.block 2 


rl0L 

= 

$16 

rl0H 

= 

$17 

rii! 

.block 2 


rllL 

= 

$18 

rllH 

ss 

$19 

rl2: 

.block 2 


rl2L 

= 

$lfl 

rl2H 

- 

$1B 

rl3i 

.block 2 


rl3L 

= 

$1C 

rl3H 

= 

$10 

rl4; 

.block 2 


rl4L 

= 

$1E 

rl4H 

= 

$1F 

rl5! 

.block 2 


rl5L 

= 

$20 

rl5H 

= 

$21 


jTutte le variabili che iniziano a questa locazione vengono salvate durante 
; l'esecuzione di un accessorio da scrivania <Desk Rccessorg) e l'apertura di un 60 

s-zp-global i 

jQuesta variabile locale e' per le routine grafiche 

curPattern'. .block 2 j$0022 puntatore alla matrice grafica corrente 


jQuesta variabile viene utilizzata da GetString per memorizzare l'indirizzo 
;del buffer che l'applicazione ha allocato per ricevere la stringa di input 
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stringi .block 2 itBè24 

jVariabili globali utilizzate dai codici di gestione delle fonti caratteri per definire 
jil set di caratteri 

cardDatai 


baselineOffseti 

.block 1 

;$002£ offset dal lato superiore alla linea di base 
jnel set di caratteri 

curSetHidth: 

.block 2 

;$0027 larghezza in byte di una linea del set (somma 
jorizzontale delle larghezze di tutti i 
jcaratteri nel set) 

curHeighti 

.block 1 

;$0029 corpo carattere del set (altezza in pixel, 
jnumero di linee o point size del set) 

curlndexTable: 

.block 2 

j$002fl offset dal primo byte della fonte su disco 
jall'inizio della tavola indice contenente gli 
;offset in pixel per ogni carattere del set (questi 
joffset sono relativi all'inizio di ogni linea del 
;set) 

cardDataPntr: 

.block 2 

j$002C puntatore all'inizio della prima linea del 
;set Ln memoria; l'indirizzo delle altre linee 
; viene calcolato da GEOS aggiungendo l'offset 
;»emorizzato in curSetUidth 

endCardOatai 

CflRD-OflTfl-lTEMS 

= endCardData 

- cardData 

jModo corrente 

(stile) di visualizzazione dei caratteri 

t 

Xlxxxxxxx 

underline (sottolineato) 

f 

!i0XXXXXXX 

no underline 

f 

lixlxxxxxx 

italic (corsivo) 

f 

'ÌX0XXXXXX 

no italic 

t 

^xxlxxxxx 

reverse (negativo) 

1 

!(XX0XXXXX 

no reverse 

currentllode: 

.block 1 

;t002E modo corrente di scrittura 

;Questo flag controlla lo stato 

di attività' dello schermo principale e di quello nascosto 

dispBufferOni 

.block 1 

;$002F bit 7 - controlla l'accesso allo schermo principale 


bit 6 - controlla l'accesso allo schermo nascosto 
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;Quésta variabile globale indica io stato del eouse, dei aenu e delle icone 


■ouseOn; 


.block 1 


19038 bit 7 - nouse on(l)/off(8) 

bit 6 - eenu on<l)/off(0) 
bit 5 - icone on(l)/oFf<0) 


■sePicPtr! .block 2 j<0831 puntatore ai dati grafici del eouse 

,‘Queste variabili globali vengono utilizzate dalle routine grafiche e di gestione 

idei testi per eascherare. Nella versione 1.1 solo le routine di gestione dei testi riconoscono 

jgueste variabili 


uindouTopi .block 1 
windouBottoe: .block 1 
leftHargin; .block 2 

rightNargini .block 2 


;I0033 linea superiore della finestra oltre la quale viene 

;operato il aascheraiento dei testi 

;I0034 linea inferiore della finestra oltre la quale viene 

joperato il eascheratento dei testi 

;$0035 punto piu' a sinistra per visualizzare i caratteri 

jCR posiziona il cursore a questa distanza dal lato 

;sinistro dello scherno 

JI0037 punto piu' a destra per visualizzare i caratteri 
;se viene oltrepassato, GEOS esegue la routine puntata dal 
jvettore stringFaultVec 


;Qui finisce la zona di pagina 0 che GEOS salva durante l'esecuzione di un accessorio 
;da scrivania (Desk flccessorg) o durante l'apertura di un BD (Box di Dialogo) 


e-zp-global ; 


;11 flag che segue indica lo stato del louse e se e' stato prenuto un tasto 


pressFlag: .block 1 


$0039 

bit 7 - inpostato a 1 da InterruptHain se l'utente ha 
prenuto un tasto sulla tastiera 
bit 6 - il nouse ha canbiato il suo stato 
bit 5 - il pulsante del nouse ha canbiato il suo stato 


;Posizioni del House 

nouseXPos! .block 2 

nouseYPosi .block 1 


;$003fl coordinata x del nouse 
j$003C coordinata y del nouse 
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;Questa variabile viene utilizzata da GEOS per le routine che prevedono la chiamata inline 
returnflddress! .block 2 ;(963D indirizzo al quale ritornare dopo la chiaaata inline 

;a una routine. Viene impiegata da DoInlineReturn 

graphicsHode! .block 1 ;$003F $08 per VIC (C-S4) 

;$80 per VOC 648 x 200 (C-128) 

;$C8 per VOC 840 x 400 (C-128, na non attivabile) 


! tmmtmttmmmmmtmmmmmmmmtmmmmmttmmmmtmm 


Spazio in pagina 8 per le applicazioni, che NON dev'essere usato da GEOS e 
dagli accessori da scrivania 

mmmmmtmmmmmmmtmtmmmmmmmmmmmmmmmm 


a0 

- 

$FB 

aSL 

- 

$FB 

a0H 


$FC 

al 

- 

$FD 

alL 

« 

$FD 

alH 

- 

$FE 

a2 

m 

$70 

a2L 

- 

$70 

a2H 

= 

$71 

a3 

- 

$72 

a3L 

- 

$72 

a3H 

- 

$73 

a4 

- 

$74 

a4L 

- 

$74 

a4H 

- 

$75 

a5 

- 

$76 

a5L 

a 

$76 

aSH 

- 

$77 

a6 

- 

$78 

aSL 

- 

$78 

aSH 

•1 

$79 

a? 


$7fl 

a7L 

- 

$7fl 

a7H 

- 

$7B 

a8 

- 

$7C 

aSL 

- 

$7C 

a8H 

> 

$70 
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aS 


$7E 

a9L 

= 

$7E 

a9H 

se 

$7F 


i nnuutuntntntuuuuunttttuttttttttttutttttttttutttuututnnnntutnun 

; Inizio della RRH di sistema impiegata da GEOS 

jNota: quest'area della memoria inizia con i buffer da 25S byte usati durante gli accessi 
;al disco. Se vengono riallocati, devono sempre iniziare con il primo byte di una pagina 
jdella memoria 



.ramsect 

diskBlkBuf; 

.block 

256 

fileHeader! 

.block 

256 

curDirHead! 

.block 

256 

fileTrScTab! 

.block 

256 


OS-VflRS ;$8000 

)*8000 buffer per contenere un qualunque blocco 
idei disco 

j$8100 buffer per contenere il File Header Block 
idi un file GEOS 

i$8200 buffer per contenere il Directory Header Block 
idei disco 

i$8300 buffer utilizzato per contenere gli indirizzi T/S dei 
isettori che realizzano il concatenamento del file 
iDal momento che normalmente il primo indirizzo T/S 
iindividua il blocco File Header del file, il numero 
idi indirizzi non può' essere superiore a 127 e quindi 
iil file non può' essere piu' lungo di 32,258 byte. Se si 
ideve salvare sul disco un file di dimensioni maggiori, 
ipossono essere utilizzate le routine di 
ilettura/scrittura parziale, e una speciale tavola 
;di indirizzi T/S di dimensioni sufficienti 


startRamZero: ; Inizio della RRH che viene automaticamente azzerata durante 

; 1'installazione del sistema (booting). Da questo indirizzo 
jfino a t88FF le locazioni di memoria vengono azzerate 

.block 30 ;I8400 buffer utilizzato per creare il File Entry di un file 


dirEntryBufi 





APPENDICE B: VARIABILI GEOS GLOBALI 


527 


; utttuuuuuntututtuuttttuttttttttuututtutuuuttnututuuuuuuuutu 

; Variabili per gli accessi al disco 

; uuuuuututtututtuttuutttuuutuutttuutututttuuuuuuttttttuuuttu 


jl due buffer che seguono contengono il nome del disco corrente contenuto in uno dei due 
;possibili disk drive 


DrflCurOkNffii 

DrBCurDkNm: 

dataFileNane: 

dataDiskName: 

prntFileName! 

prntDiskName; 

curDrivei 

diskOpenFlgi 

isGEOS; 

interleave: 

numOrives: 

driveType: 


turboFlagsi 


.block 18 
.block 18 
.block 17 
.block 18 
.block 17 

.block OK-NH-ID-LEN + 1 

.block 1 
.block 1 
.block 1 

.block 1 

.block 1 
.block 4 


.block 4 


jl841E none del disco nel drive B 

il6 caratteri per il nome + 2 caratteri per l'IO 

;$8430 nome del disco nel drive B 

jl6 caratteri per il nome + 2 caratteri per l'ID 

; 18442 nome del file dati che dev'essere passato 

;aH 'applicazione 

;$8453 nome del disco sul quale e' memorizzato il 
;file dati 

;$84€5 none del driver di stampa selezionato 

)16 byte per il nome + 1 terminatore 

;I847€ nome del disco sul quale e' residente il 

jdriver di stanpa selezionato 

;18 byte per il nome del disco + 1 terminatore 

)$8489 drive correntemente attivo <8, 9, 18 o 11) 

j$848B indica se un disco e' aperto 

;$8486 questo flag indica se il disco 

;e' in formatoGEOS 

;$848C Blkfìlloc utilizza questo valore quando 
jseleziona i settori del disco per creare il 
iconcatenamento richiesto. GEOS inizializza 
;questa variabile a 8 

;$848D numero dei drive attivi collegati al 
;sistema 

;$848E tipo del disk drive (questa variabile non 
;viene attualmente utilizzata) 

;1 byte per ogni drive possibile: 8, 9, 10 ,11 
;Le costanti per queste variabili sono riportate 
; nell'appendice R come "DRV-1541" 

;I8492 flag di stato del turbo (attualmente sono 
;utilizzati solo i due primi byte, dal momento che 
jil sistema si può' configurare solo per due drive) 
;Flag per il turbo dei drive 8, 9, 10, 11 
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Bit Si 0 turbo residente nel drive, sa 
correntesente disattivato 
1 turbo in esecuzione 
Bit 7ì 0 turbo non residente 
nel drive 

1 turbo residente nel drive 


;l>lariabili santenute da GEOS per contenere le inforsazioni sul file SEQUENTlfìL o VLIR 
jcorrentesente aperto 


curRecordi 

.block 1 

jt8496 record corrente 

usedRecordsi 

.block 1 

;f8497 nusero dei record nel file aperto 

fileUritten! 

.block 1 

;$8498 flag per indicare se il file e' stato 
;aggiornato dopo l'ultisa sodifica effettuata 
;nella tavola indice e nella BAH 

fileSize: 

.block 2 

;$8499 disensione corrente (in blocchi) del file 
jQuesto paratetro viene letto e scritto nel File 
;Entrg del file 


jLe variabili che seguono vengono tenporaneatente salvate durante l'apertura di un BO o 
; l'esecuzione di un accessorio da scrivania 

s-nonzp-global: 


! ttmmmmmmmtmmmmmmmmmmmtmmmmtmmmmmtm 

I Vettori 


appHain: .block 2 


intTopVector: .block 2 


intBotVector: .block 2 


;I849B codice HainLoop dell'applicazione 
jPernette all'applicazione di includere codici 
;propri alla fine del HainLoop di sistesa 
;$8490 chiasata all'inizio della routine-di 
;interrupt di sistesa 

;pernette alle applicazioni di includere i loro 
jcodici di interrupt all'interno della routine 
;InterruptHain di sistesa 
;4849F guesto vettore viene eseguito quando 
jtersina la routine di interrupt di sistesa. In 
; questo sodo le applicazioni possono aggiungere 
;codici propri alla fine della routine di 
;interrupt di sistesa 
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«ouseVector! .block 2 

keyVector: .block 2 

inputVectori .block 2 

BOUseFaultVec: .block 2 

otherPressVeci .block 2 

stringFaultVec! .block 2 

alarnTitVector! .block 2 

BRKVector: .block 2 

recoverVectori .block 2 


$84fìl routine eseguita quando viene preauto il 
pulsante del eouse 

>84fl3 routine eseguita quando viene preauto un 
tasto della tastiera 

$8485 routine eseguita qualora avvengano dei 
caabiaaenti nel dispositivo di input 
$8487 routine eseguita quando il aouse esce dai 
liaiti della regione deliaitata o da un aenu 
$8488 routine eseguita quando il pulsante del 
aouse viene preauto su una regione dello scherao 
non convenzionale (convenzionale! aenu e icone) 
$8488 routine da chiaaare nel caso che i caratteri 
visualizzati sullo scherao oltrepassino 
il aargine destro individuato dalla variabile 
rightMargin 

$8480 routine da eseguire quando entra in 
funzione l'allarae interno del C-64. L'allarae 
viene iapostato dall'applicazione. Grazie a 
questa routine può' essere generato un suono 
particolare, oppure un segnale luainoso sullo 
scherao 

$848F routine da eseguire quando il processore 
si trova a eseguire l'istruzione BRK 
$8461 routine che viene eseguita per ripristina¬ 
re io scherao alla chiusura di un aenu, di un 
box di dialogo o di un desk accessorg 


;La variabile che segue deteraina la velocita' alla quale si invertono le icone e 
;le opzioni dei aenu quando vengono selezionate 


selectionFlash: .block 1 ;$84B3 


;La variabile che segue viene utilizzata durante l'input di stringhe 


alphaFlag! .block 1 ;$8464 alphaFlag contiene alcuni bit che governa- 

;no il cursore visibile. Se il bit 7 e' iapostato a 
;1, il cursore visibile e' attivato. In questo caso 
;il bit € aantiene lo stato del cursore visibile. 
jHentre il cursore laapeggia, il bit 6 indica se e' 
racceso o spento. Quando e' iapostato a 8 il cursore 
^visibile e' spento. I 6 bit riaanenti 
jcostituiscono un contatore per deterainare il 
;ritao del laapeggio 
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jLa variabile che segue contiene due bit, bit 7 e bit 6, che specificano in che sodo GEOS 
;segnala all'utente la selezione di un'icona, Se nessuno dei due e' impostato a 1, 
jil sistema non compie alcuna azione particolare per segnalare all'utente la selezione di 
;un'icona, ed esegue semplicemente la routine di servizio associa.ta. I due flag possibili per 
;questa variabile sonoi ST-FLflSH=l80, inverte momentaneamente l'icona selezionata 
;ST.INVERT=I40, inverte in modo permanente l'icona selezionata Se il bit individuato da 
;ST-FLRSH e' impostato a 1, il bit 6 viene ignorato e l'icona si inverte per una frazione di 
jsecondo quando viene selezionata, Se il bit individuato da ST-INVERT e' impostato ale 
;il bit 7 e' impostato a 0, l'icona viene invertita permanentemente 

iconSetFlagi ,block 1 ;$84B5 

jQuesta variabile riporta gli errori di spostamento del mouse 

faultData: ,block 1 ;$84B6 bit di flag per gli errori del mouse, 

;questa variabile viene normalmente controllata 
;dalla routine puntata dal vettore mouseFaultVec 
;I possibili valori che può' assumere sono 
jdocumentati nell'appendice fì 


; utututnmtttuntttnuunuuutttntutmunntittmtutunttuttuttttutuu 

; Variabili globali relative alla gestione del mouse 


menuNumber: , block 1 


;$84B7 numero di menu attivi 


;Quando il mouse oltrepassa uno dei limiti imposti dalle seguenti variabili, GEOS 
;manda in esecuzione il vettore mouseFaultVec 


mouseTop: ,block 1 
mouseBottom: ,block 1 
mouseLeftì ,block 2 
mouseRight; ,block 2 


;$84B8 massima altezza per il mouse 
;I84B9 minima altezza per il mouse 
)t84Bfl confine sinistro per il mouse 
;$84Bc confine destro per il mouse 


^Variabili globali per la gestione delle stringhe in input e del cursore 


stringX: ,block 2 


;I846E coordinata x del punto in cui 
; l'eco sullo schermo durante l'input 
jl84C0 coordinata g del punto in cui 
; l'eco sullo schermo durante l'input 


generare 
di stringhe 
generare 
di stringhe 


stringY; 


,block 1 
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e-nonzp. 9 lobal; ;Ques|a e' la fine delle variabili globali non 

; residenti in pagina 0 che vengono salvate durante 
; l'apertura dei box di dialogo e l'esecuzione 
; degli accessori da scrivania 


nousePicData: .block 64 

eaxHouseSpeed: .block 1 
ainnouseSpeed: .block 1 
nouseaccel: .block 1 


j$84Cl aatrice in RRH che contiene i dati grafici 
;del disegno del aouse 

;$8561 velocita' nassioia di spostamento del mouse 
j$8562 velocita' minina di spostamento del mouse 
j$8503 accelerazione del mouse 


;Le variabili globali che seguono mantengono lo stato corrente del mouse e della tastiera 


kegData: 

.block 1 

j$8504 questa e' la variabile che contiene il 
;codice del tasto premuto. La routine di servizio 
;della tastiera deve accedere a questa variabile 

mouseOatai 

.block 1 

j$850S questa e' la variabile alla quale la routine 
;di servizio del mouse deve accedere per leggere lo 
jstato del dispositivo di input 

inputData: 

.block 4 

j$8506 queste 4 variabili sono a disposizione dei 
jdriver di input per passare informazioni speci- 
)fiche per il particolare dispositivo di input 


;Numero random. Viene incrementato a ogni chiamata di interrupt 


random: .block 2 j$850R 

saveFontTab: .block 9 ;$850C guando si accede ai menuj si deve salvare la 

; tavola di definizione della fonte corrente in 
jguesto buffer 

;La variabile che segue viene impiegata per registrare la doppia pressione del pulsante 
;del mouse sopra un'icona 

;dblClickCount viene aggiornata con un particolare valore quando l'icona viene selezionata 
;con la prima pressione del pulsante del mouse 

jDal momento che in questo periodo di tempo la variabile contiene un valore diverso 

;da zero, la routine di interrupt di sistema provvede a decrementarla a ogni chiamata 

;Se quando l'icona viene nuovamente selezionata il valore in dblClickCount non e' 0, 

;GE0S stabilisce che l'utente ha selezionato l'icona due volte in rapida successione, e 
jrestituisce alla routine di servizio il valore TRUE nel registro r0H. Se invece 
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jla variabile dblClickCount e' 0 quando l'utente la seleziona di nuovo, GEOS passa il 
jvalore FALSE in r0H 

dblClickCount: .block 1 j$8515 viene utilizzata per determinare le doppie 

^pressioni del pulsante del mouse sopra un'icona 

^Variabili associate alla data e all'ora di sistema 

year: .block 1 jl851S 

month; .block 1 ;$8517 

day: .block 1 jl8518 

hour: .block 1 jl8519 

minutes: .block 1 ;I851R 


seconds: .block 1 j$8S16 

;La variabile globale che segue comanda l'abilitazione deH'allarme 

alarmSetFlag: .block 1 j$851C se vale TRUE l'allarme non e' impostato 

;Se vale FALSE l'allarme e' inserito 

;Le variabili che seguono sono associate alla gestione dei box di dialogo 


sgsDGData .block 1 j$851D viene utilizzata internamente per 

;determinare quale comando ha causato la chiusura 
jdel BD e il ritorno all'applicazione. Il codice 
;del comando viene restituito in r0L 

screenColors; .block 1 ;$851E colore di default dello scherno 


;Si calcola il valore delle costanti che seguono per decidere la dimensione del buffer 
; impiegato per salvare tutte le variabili RRH che caratterizzano lo stato 
jdell'applicazione. Queste costanti individuano tutta le variabili RAH specificate 
snella tavola saveSysRanTab utilizzata dal nodulo SaveSysRam 


MENILSPACE - (3 * HAXIHUNJIEHU-HESTING) + <2 I HAXIMUHJIEHU-ITEHS) 

j$802A byte interessati 
SRAM-ZP-GLOBAL - e-zp.global - s-zp.global 

j$0017 byte interessati 
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SRBHilONZP-GLOBflL « e-nonzp.global - sjìonzp. 9 l«bal 

;I002( bgt* interessati 

SRflMOCflL - 2 + 14+HENU-SPftCE + («flXIHWLPROCESSES C 8) + (SLEEP-MftXIMUII * 4) 

;$012R byte interessati 

SRflH-SPRITES X 10026 «byte interessati 

TOT-SRfltLSflyED 

- SRflll2PJ;LOBfìL+SRfllUtONZPJU.OBflL4-SRRIUOCRL+SRRH-SPRITES-l-20 
;>01R1 byte interessati 

dlgBoxRaaBuf! .block TOT-SRRH-SRVED ;I891F buffer per salvare tutte le variabili di sisteaa 

;che caratterizzano l'applicazione, specificate 
; nella tavola saveSysRaiTab 


; mmmmmmmmttnttmmttmmmmmnmmtttmmtmtmmmtmtt 

ì Seconda area di aeaoria per le variabili globali 

; mmmnmtmttmtmttmmmmmmmtmmtmnmmmtmnmtmmtt 


jLe variabili che seguono sono raccolte in una seconda area globale di eenoria. Queste 
; variabili vengono utilizzate dalle applicazioni create per GEOS VI.3 e dallo stesso Kernel 
iVl.3. Dal eoeento che l'utente può' anche eandare in esecuzione deskTop VI.3 sotto GEOS 
;V1.2, e' eolto ieportante che queste variabili siano allocate senpre nella stessa area 
jdi aeaoria. In questo aodo, per eseapio, l'utente che possiede GEOS Vi.2 e ha ricevuto 
jdeskTop VI.3 via Q*LIHK, può' ugualaente giovarsi dell'auto-booting dei driver di input 
;Per ragioni di coapatibilita', queste variabili devono quindi essere allocate seapre 
;nella stessa area 

.raasect $88BB 

savedaobyZi .block 1 j$88BB questa variabile dev'essere aggiornata con 

;il valore contenuto in aobyZ durante l'apertura 
;del box di dialogo e l'esecuzione dei desk 
jaccessory, per evitare che possa essere alterata 
iDal aoaento che nei codici originali di GEOS la 
^variabile aoby2 non viene teaporaneaaente 
; salvata durante i BD e i DR, deve provvedere la 
jstessa applicazione 

scr88polar! .block i ;I88BC copia del registro 24 contenuto nel VDC del 

jC-128 

scrBBcolors! .block 1 j>88BD colori di scherao per il aodo a 86 colonne 

jdel C-Ì28, copia del registro 26 del VDC 
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vdcClrHode! 

driveData; 

ra»ExpSize: 

sysRfldFIg; 


FirsiBootI 

curTypei 

ranGase: 

inputDevNane: 


.block 1 
.block 2 

.block i 
.block 1 


.block 1 

.block 1 
.block 4 

.block 17 


jIGSBE aantiene il nodo colore corrente impiegato 
jdalle routine del colore del C-128 
jIBBBF 1 byte per ogni dispositivo che il disk 
^driver corrente e' in grado di gestire (ogni 
jdriver può' comandarne diversi) 

;I88C3 numero di banchi di memoria 
; dell'espansione installata 
j$88C4 se e' presente un'espansione RfiM, 
jil banco 8 

eviene riservato all'uso interno del Kernel 
;Questa variabile indica a quale uso viene 
^dedicato: 

;Bit 7: se impostato a 1, $0000-$78FF impiegata 
jdalla routine KoveData 

;Bit 6: se impostato a 1, $8300-IB8FF contiene i 
jdisk driver per i drive daH'fl ai C 
;Bit 5: se impostato a 1, l7900-t7DFF ToBasic vi 
jmemorizza l'area RAM di GEOS ♦8400-$88FF quando 
;il controllo viene restituito al Basic 
;Bit 4i se impostato a 1, $7E00-f82FF un file 
jRUTO-EXEC di setup vi memorizza i codici di 
jricaricamento (reboot). Questi codici vengono 
jricaricati in memoria a 16000, al posto del file 
;GE0S-B00T, dal codice di restart, locato a $C000, 
jse questo flag e' impostato a 1. Inoltre, 
jnell'area $B900-IFC3F viene salvato il Kernel in 
jmaniera che possa essere installato nuovamente 
jl'intero sistema senza che siano compiuti accessi 
;al disco (secondo le variabili impostate dal file 
;setup). Quest'area dovrebbe essere aggiornata 
;quando vengono cambiati i dispositivi di input 
j(operazione che viene compiuta da deskTop VI.3) 
JI88C5 questo flag viene cambiato da $00 a IFF 
jquando deskTop viene caricata per la prima volta 
jdurante l'installazione del sistema 
,'I88C6 tipo di disco corrente (copiata da 
jdiskType) 

j$88C7 banco di RfiM dell'espansione per ogni drive 
,‘da impiegare nel caso che il drive sia di tipo RfiM 
;disk 0 Shadoued 

;$88CB mantiene il nome del dispositivo di input 
jcorrente 
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DrCCurOkNm 

.block 18 

jt880C noM del disco contenuto nel drive C 
;18 caratteri conclusi con $88 

DrDCurDkNii 

.block 18 

;$88EE noie del disco contenuto nel drive D 
jl8 caratteri conclusi con $89 

EndRaaZero! 


jFine dell'area di aeioria che GEOS azzera durante 
; l'installazione iniziale 

dirZHeadi 

.block 256 

;$8900 secondo Directory Header Blockj per 
;dischi foriattati da drive con capacita' 

;iaggiori (coie il 1571) 

.end 

.ransect 

EndGlobal 





C APPENDICE C: 
ROUTINE 


• nmtmmmmmmnmmmnmmmmmmmmmmmmmmmumm 

t 

1 geosRoutines 

;Questo file contiene la tavola degli entry-point (o junp-call) a disposizione 
jdelle applicazioni per chiaaare le routine di GEOS 


intmmmmtmnmtmmmnmmmmnmmmmtmnmmmmmmtm 


;Routine generali 

;I due entry point che seguono sono gli unici leeorizzati a $C000. Tutti gli altri iniziano 

;da OS-JUHPTfiB 

BootGEOS > $C000 ;Ricarica GEOS integralmente, a condizione pero' 

;.che i codici da IC000 a $C02F non siano stati 
;alterati 

ResetHandle - IC003 {Riattiva GEOS attraverso la procedura di Cold 

{Start (partenza a freddo). Presuppone che GEOS 
{Sia già' stato interamente caricato in memoria 



538 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


)Gli entry point 

che seguono sono 

locati da OS-JUMPTfiB in poi 

InterruptHain 


Idee 

intttmtmntmmmmmmtmtmm 

j PROCESSI 

itmnmtnumtnmtnmnmmmmt 

InitProcesses 

= 

«103 


RestartProcess 

= 

IC106 


EnableProcess 

» 

$C109 


BlockProcess 

ss 

«10C 


UnblockProcess 

- 

«10F 


FreezeProcess 

s 

$C112 


UnfreezeProcess 


$C115 

ituuuuntiuintuiuttuitttittnnnui 

j GRAFICA 

immtmmmmtmmnmmutmmt 

HorizontalLine 

= 

$C118 


InvertLine 

= 

$C11B 


RecoverLine 

- 

ICllE 


VerticalLine 

= 

IC121 


Rectangle 

ae 

IC124 


FraaeRectangle 

= 

$C127 


InvertRectangle 

- 

IC12fi 


RecoverRectangle 

= 

$C12D 


DrauLine 

SE 

$C130 


DrawPoint 

= 

$C133 


GraphicsString 

SS 

$C136 


SetPattern 

as 

«139 


GetScanLine 

= 

«13C 


TestPoint 


$C13F 

ituuttttttutttuunuuiuiinnumutt 

j GEICRAZIONE m UNA SCICRMATA 

•,ntunnunnuntttnntntnnnunttu 

BitnapUp 


$C142 

immmmmxmtttmtmmmmmm 

! MANIPOLAZIOItf DEI CARATTERI 

ittmxxxtttntxuttuttttmttxxnnmux** 

PutChar 

= 

«145 


PutString 

= 

«148 


UseSystemFont 

= 

«14B 
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StartMouseUode 

DoMenu 

RecoverMenu 

RecoverfìllMenus 

Dolcons 


DShiftLeft 

BBMult 

BMult 

onuit 

Odiv 

DSdiv 

Dabs 

Dnegate 

Ddac 

ClearRait 

FillRam 

MoveDala 

InitRam 

PutDee inai 

GetRandon 


Mousellp 

MouseOff 

DoPreviousMenu 

ReDoMenu 

GetSerialNunber 

Sleep 

ClearMousenode 

i-Rectangle 

i-FraneRectangle 

i-RecoverRectangle 

i-GraphicsString 


ittmtmmmunmnnnnnmnmtm 

! MOUSE, MENU E ICONE 

• tmttutmmnmmummnmmmn 

$C14E 

$C151 

$C154 

IC157 

*C15fl 

itmumnmnmmttmnnnnmmm 

j UTILITY 

ìtttttnnttnitntnunnuutnutnntnt 

$C15D 
$C160 
$C163 
$C166 
$C169 
$C16C 
«16F 
tC172 
$C175 
$C178 
$C17B 
$C17E 
$C181 
«CI 84 
$C187 

ittttitttitttttttHttiitttttitttiiHtittttttt 

; MOUSE, MENU, GRAFICA, SLEEP 

iuunnnunuuntuutuuuununnu 

$C18fl 

IC18D 

*C190 

tC193 

$C196 

$C199 

$C19C 

$C19F 

$Clfl2 

IClf)5 

$C1R8 
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Ì-6ÌttàpUp 

s 

ICIRB 

i-PutString 


IClflE 

GetRealSize 


$ClBi 

i-FillRaa 


$C1B4 

ìJloveData 


$C1B7 


GetString 

= 

ICIBR 

GotoFirstMenu 

= 

ICIBO 

InitTextProapt 

- 

IC1C0 

HainLoop 

« 

$C1C3 

DrawSprite 

= 

$C1C6 

GetCharUidth 

xs 

»C1C9 

LoadCharSet 

3S 

ICICC 

PosSprite 

- 

ICICF 

EnablSprite 

- 

IC102 

OisablSprite 

- 

TC1D5 

CallRoutine 


ICIDB 

CalcBlksFree 

- 

ICiDB 

ChkDkGEOS 

= 

ICIDE 

NewDisk 

- 

ICIEI 

GetBlock 

- 

$C1E4 

PutBlock 

- 

IC1E7 

SetGEOSDisk 

- 

IClEfl 

SaveFile 

s 

ICIED 

SetGOirEntry 

- 

$C1F0 

BldGDirEntry 

- 

♦C1F3 

GetFreeDirBlk 

m 

$C1F6 

HriteFile 

- 

»C1F9 

Blkfllloc 

= 

ICIFC 

ReadFile 

> 

$C1FF 


immmmttmmmmmtmmmtmt 

ì GENERAZIONE DI UNA SCHERMATA 

itnnmmmmmtmmmmnmmm 

itmtmmmmttmmmmmmtmm 

; MANIPOLAZIONE DEI CARATTERI 

■ttntnunnttttuntutttnutttnttnttn 


ìtttutttttttitttntntnntntxttutnttttti 

iUTIUTY 

ittmmmnmmmmtmtmmnmnt 


• tttnnttmtmmtmmmmmmmm 

j ROUTINE AGGIUNTE 
; SUCCESSIVAMENTE 

innntttimtnmmmmttmmmtnu 
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SiallPutChar 

- 

«C282 

FollowChain 

'm 

«0205 

GetFile 

- 

«C288 

FindFile 

- 

«C20B 

CRC 

« 

«C20E 

LdFile 

m 

«C211 

EnterTurbo 

m 

«C214 

LdOeskRcc 

- 

«C217 

ReadBlock 

- 

«C21fl 

LdRpplic 

- 

«C2iD 

UriteBlock 

- 

«C228 

VerUriteBlock 

« 

«C223 

FreeFile 

- 

«C226 

GetFHdrInfo 

- 

«C229 

EnterOeskTop 

m 

«C22C 

StartRppl 

» 

«C22F 

ExitTurbo 

- 

«C232 

PurgeTurbo 

- 

«C235 

DeleteFile 

m 

«C238 

FindFTypes 

» 

«C23B 

RstrRppl 

- 

«C23E 

ToBasic 

- 

«C241 

FastDelFile 

- 

«C244 

GetOirHead 

- 

«C247 

PutOirHead 

- 

«C24R 

NxtBlkRlloc 

- 

«C24D 

liprintRectangle 

m 

«C258 

i-IaprintRectangle 

- 

«C2S3 

OoDlgBox 

m 

«C256 

RenaaeFile 

- 

«C259 

InitForlO 

- 

«C25C 

DoneHithIO 

- 

«C25F 

DShiftRight 

- 

«C262 

CopyString 

- 

«C265 

CopyFString 

- 

«C268 

CapString 

- 

«C26B 

CapFString 

- 

«C26E 

Firstlnit 

- 

♦C271 

OpenRecordFile 

- 

«C274 

CloseRecordFile 

- 

«C277 

NextRecord 

- 

«C27R 

PreviousRecord 

- 

«C270 
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PointRecord 

DeleteRecord 

InsertRecord 

flppendRecord 

ReadRecord 

WriteRecord 

SetNextFree 

UpdateRecordFile 

GetPtrCurDkNm 

ProiptOn 

Pro«ptOff 

OpenDisk 

OoInLineReturn 

GetNextChar 

BitnapClip 

FindBRnBit 

SetDevice 

IsHselnRegion 

ReadByte 


$C280 

$C283 

$C286 

$C289 

»C28C 

$C28F 

$C292 

$C295 

*C298 

$C29B 

IC29E 

$C2fll 

$C2fl4 

$C2fl7 

$C2Rfì 

$C2fiD 

IC2B8 

$C2B3 

IC266 


;La routine che segue, FreeBlock, e' direttaaente accessibile all'indirizzo IC2B9 solo 
;dalla versione 1.3 del Kernel. Per la versione 1.2 si deve utilizzare la chianata diretta 
;aH'indirizzo $9844 


FreeBlock - $C2B9 
ChangeOiskDevice = $C2BC 
RstrFrnDialogue - $C2BF 
Panie = $C2C2 
BitOtherClip = IC2C5 


jRoutine per la gestione delle espansioni RAM Queste routine sono disponibili solo nelle 
eversioni del Kernel successive alla 1.2 


StashRRM 

= 

$C2C8 

FetchRRM 

= 

$C2CB 

SwapRRH 

» 

$C2CE 

VerifyRRH 

a 

IC2D1 

OoRRHop 

a 

$C204 
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immmmmmnmmtnnnmnntm 

;Dm«ER DI STAMPA 

ìtmmttmmtttmtntmmmmitnm 


InitForPrint 

= 

$7900 

jPRINTBflSE 

StartPrint 

= 

$7903 


PrintBuffer 

se 

$7906 


StopPrint 

- 

$7909 


CetDinensions 

= 

$790C 


PrintflSCII 

- 

$790F 


StartflSCII 

= 

$7912 


SetNLQ 


$7915 







D APPENDICE D: 
MAGRO ISTRUZIONI 


In questo file sono lipoitate tutte le macio istruzioni per il compilatore citate nel 
testo. Sono state esplicitamente create per il nostro compilatore, e quindi possono non 
essere adatte ad altri compilatori. In questo caso è necessario trasformarle o espanderle 
nei listati sorgente. 

■ tiuntttntunttnttitttttntutttutnttutnutunntnutnutttutnuunnttttnt 

; 

; geosllacros 
/ 

ì II file contiene alcune definizioni di nacro che possono 
; essere iapiegate nella realizzazione delle applicazioni 
/ 

; ttmmmmtmutttmmtmttmmntxtnttnmmnmmmmmmmmmm 


mnmmmmnmmmmtntttumttnuntmtnmmmmnmnmtmtmtn 

Load Byte: LoadB dest, valore 

Brgoaenti: dest indirizzo del byte nel quale dev'essere 

■eaorizzato “valore” 

valore valore del byte da nenorizzare 

Funzionai Neaorizza "valore" nel byte dest 


tttttttmmmmtmttmmnmnmmmttmnmtttmtntttmtmntmnmut 
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■macro LoadB dest, valore 

Ida ivalore jcarica valore 

sta dest je lo memorizza 

, endm 




; Load Mordi 

LoadW dest; valore 


ì 

i Argomenti; 

* 

dest 

indirizzo della uiord nella quale 
dev'essere memorizzato "valore" 

f 

valore 

uiord da memorizzare 

f 

! Funzione; 

Memorizza "valore" 

nella word dest 

i 

,macro LoadU 

dest; valore 


Ida 

#>(valore) 

jpreleva il byte alto di "valore" 

sta 

dest + 1 

;e lo memorizza 

Ida 

#<(valore) 

;preleva il byte basso di “valore" 

S t à 

dest + 8 

;e lo memorizza 

.endm 




} 

! Move Byte; 

MoveB sorg; dest 


; Argomenti; 

sorg 

indirizzo sorgente 

f 

dest 

indirizzo destinazione 

! Funzione; 

Muove il contenuto 

del byte sorg in dest 

f 

.macro MoveB 

sorg; dest 


Ida 

sorg 

;preleva il valore dal byte sorg 

sta 

dest 

je lo memorizza in dest 

. endm 
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; Move Word: MoveW sorg, dest 

} 

; Argomenti I sorg 

; dest 


indirizzo sorgente 
indirizzo destinazione 


; FunzioneI Muove il contenuto di una word 

; dall'indirizzo sorg all'indirizzo dest 




.macro 


. endi» 


MoveW 

sorg, dest 



Ida 

sorg + 1 

jpreleva il byte 

alto 

sta 

dest + 1 

;e lo memorizza 


Ida 

sorg + 0 

jpreleva il byte 

basso 

sta 

dest + 0 

;e lo memorizza 



fldd Byte; add sorg 

f 

i Argomenti; sorg indirizzo del byte da sommare^ o 

; valore immediato da sommare 


; Funzione; a = a + sorg 

f 

•macro add sorg 

eie 
adc 


• endm 


sorg 
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! tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt 

1 Rdd Bytesi 
} 

; Rrgoienti: 


1 Funzione! 

} 

; mtmmttmmmmmmmttmttmtmmtmtmmmmttmtmtntmnmn 


.nacro 

RddB 

eie 

sorg, dest 

jla sona avviene senza riporto iniziale 


Ida 

sorg 

;preleva il byte sorg 


adc 

dest 

jlo sona al byte dest 

.endn 

sta 

dest 

;ieiorizza il risultato 


RddB sorg, dest 

sorg indirizzo del byte da soMiare 

dest indirizzo del byte da sonare che riceve 

il risultato 

dest - dest + sorg 


; nmtnmmnmmntttmmmmmmmmtnmtmttmmtttmnttttnttum 


; Rdd Uords: 

RddU sorg, dest 


} 

; Rrgoienti: 

sorg 

indirizzo della word da soaaare 

> 

dest 

indirizzo della word destinazione da sostare 

f 

ì Funzione; 

dest « dest + sorg 


f 

; mmmmtmmtmmtmmmtmmmtmmtmmttumtmmmttxtttuum 

.■acro RddU 

sorg, dest 


Ida 

sorg 

; preleva il byte basso da sorg 

eie 



adc 

dest + 0 

;lo soaaa al byte basso destinazione 

sta 

dest + 0 

jteaorizza il risultato, e riporta 



jil carry 

Ida 

sorg + 1 

^preleva il byte alto da sorg 

adc 

dest + 1 

ilo soaaa al byte alto destinazione 

sta 

dest + 1 

;aeBorizza il risultato 


.endm 
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i unuunuutnntuunnnunnnntntnnnnunnnnnttuuuntuutuutuut 

/ 

ì fldd Value To Bytei flddyB valore, dest 

f 

I Rrgonentii valore costante da sommare a dest 

; dest indirizzo del byte dest 

f 

i Funzione; dest = dest + valore 

I tntnttntnttnnnttnttnntnnnttutnutntutttututtttutuutnutnnnuuu 

.macro fiddVB valore, dest 

Ida dest 

eie 

adc #valore 

sta dest 

.endm 

; ttnnuuuunuttututnutuuuuutuutuuttuuuuunuttuutuutnuutnu 

t 

i fìdd Value To Mordi RddVM valore, dest 

J 

; Rrgomenti: valore costante da sommare a dest 

; dest indirizzo della uord dest 

l 

) Funzione; dest = dest + valore 

} 

; ttttttttittitttttttHtttttttttttttttttttittttttttttttttttttttttttttttttttttttttttttttttitt 


.macro 

RddVH 

eie 

valore, dest 

; inizialmente nessun riporto 


Ida 

#<(valore) 

;preleva il byte basso di valore 


adc 

dest + 0 

je lo somma al byte basso della word 


sta 

dest + 0 

{memorizza il risultato 

• if 


(valore >= 0) 

U (valore <= 255) 


bcc 

nolnc 

jc'e' riporto se la somma ha prodotto 
joverflou 

nolnc; 

.else 

ine 

dest + 1 

{incrementa il byte alto della word 


Ida 

#>(valore) 

{c'e' riporto se la somma ha prodotto 
{overflow 
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adc dest + 1 

sta dest + 1 

■ endif 
.endm 


isomma il carry e il byte alto di valore 
jmeniorizza il risultato 


) 

; Subtract Bytei sub sorg 
) 

; Argomenti; sorg indirizzo del byte da sottrarre, o 

j valore immediato da sottrarre 


; Funzione; a = a - sorg 

} 

; mtmmmmummmmmmuuntmmmnmmmmmmmmmmmm 


.macro sub 

sorg 

sec 


sbc 

sorg 


, endm 


; mummmmmmmtmmmmmmmnmmmmmmnmtmmmmtm 


! Sub Bytes; SubB sorg, dest 

} 

; Argomenti; sorg 

; dest 


indirizzo del byte da sottrarre 
indirizzo del byte dal quale sottrarre 


; Funzione; dest = dest - sorg 

i mnmmmmmmnmuumnnnmnmnmmmunmmtmnnummnn 


.macro 


SubB 

sorg, dest 


sec 


;riporto a 1 per iniziare 

Ida 

dest 

;preleva il byte destinazione 

sbc 

sorg 

;sottrae il byte sorgente 

sta 

dest 

je memorizza il risultato 


.endm; 
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j Sub Uords: 

Subì*! sorg, dest 


i 

) Argomenti; 

sorg 

indirizzo della word da sottrarre 


dest 

indirizzo della word dalla quale sottrarre 

t 

; Funzione; 

dest = dest - sorg 


} 

; nnunnnunutnnunntuutnntuuunnutunuunutuutuutuuuuuun 

,macro SubW 

sorg, dest 


Ida 

dest + 0 

{preleva il byte basso di dest 

sec 



sbc 

sorg + 0 

jgli sottrae il byte basso di sorg 

St3 

dest + 0 

;e lo memorizza 

Ida 

dest + 1 

{preleva il byte alto di dest 

sbc 

sorg + 1 

{Sottrae il byte alto di sorg 



{con il riporto 

S13 

dest + 1 

{memorizza il risultato 


. endm 


; mmmmmmummmmmmmmmmmmmmmmnmnmmmmm 

} 

; Coiiipare Bytes; CitipB sorg, dest 
> 

j firgomenti; sorg indirizzo del primo byte 

; dest indirizzo del secondo byte 

/ 

; Funzione; Confronta il contenuto del byte 

; con quello destinazione 

i tnnnttmnunumuuuummummumnunmnmmntmnnmmnmn 

sorg, dest 

sorg ;preleva il byte sorgente 

dest ilo confronta con il byte destinazione 


•macro CmpB 
Ida 
cmp 

. endm 
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; uutttttttuuttuuuuuttuttuuttuttttuttttttuutttttuuttuntutuuuuutttt 


Compare Byte to Value: CmpBI sorg^ immed 

t 

) Rrgomenti: sorg indirizzo del primo byte 

; immed valore immediato da confrontare 


; Funzione: Confronta il contenuto di sorg con il 

; valore immediato 

f 


.macro CmpBI 
Ida 
cmp 

.endm 


sorg, immed 

sorg 

♦immed 


jpreleva il byte sorgente 
,'confronta con il valore immediato 


; xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 


; Compare Uords: CmpN sorg, dest 

t 

; Rrgomenti: sorg indirizzo della prima word 

) dest indirizzo della seconda word 


; Funzione: Confronta il contenuto della word sorg con 

; quello della word dest 

; 


.EFidCrO 


CmpM 

sorg, dest 



Ida 

sorg + 1 

jpreleva il byte alto di sorg 


cmp 

dest + 1 

jlo confronta con dest 


bne 

done 

;si deve confrontare anche il 

byte basso? 

Ida 

sorg + 0 

(esegue il confronto sul byte 

basso 

cmp 

dest + 0 

(confronta 



done: 

.endrn 
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. tmmmtmmmmmmmmummmmnmmmnmmmmmmmmmt 


; Compare Word To 

Value! CmpMI 

sorg, immed 

i 

; Argomenti! 

sorg 

indirizzo della prima word 

t 

immed 

valore immediato da confrontare 

i 

j Funzione! 

Confronta la 

word sorg con il valore immediato 

t 

; tmtmmmtnmmnmmtnmnmmtnmmmmmnmnmnmnmmmt 

.macro CmpUI sorg, immed 

Ida 

sorg + 1 

ipreleva il byte alto 

cmp 

#>( immed) 

jconfronta con il byte alto di immed 

bne 

done 

jsi deve confrontare anche il byte basso? 

Ida 

sorg + 0 

jpreleva il byte basso 

cmp 

#<( immed) 

jconfronta con il byte basso di immed 


done: 

.endm 




; Push Byte! 
; Argomenti! 

> 

; Funzione! 


PushB sorg 

sorg indirizzo del byte da inserire nello 

stack 

Inserisce nello stack il byte all'indirizzo sorg 


; ttttntmnnmtnnnmnmnmtnmuuuntmnmnmnnunnumttumm 


.macro PushB sorg 
Ida sorg 

pha 


.endm 


jpreleva il byte 

;lo memorizza nello stack 
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Push Word; 

PushW sorg 


Argomento; 

sorg 

indirizzo della word da inserire 

nello stack 

Funzione; 

Memorizza nello stack 

la word all‘indirizzo 


sorg 



macro PushW 

sorg 


Ida 

sorg + 1 

jpreleva il byte alto della word 

pha 


jlo inserisce nello stack 

Ida 

sorg + 0 

Jpreleva il byte basso della word 

pha 


jlo inserisce nello stack 


.endm 


} 

! Pop Byte: PopB dest 

t 

; Argomenti; dest locazione alla quale memorizzare il valore 

; prelevato dallo stack 

f 

; Funzione: Preleva un byte dallo stack 

f 

; nunununu%'nuuuutunn%tut%ntunnnnniut%uuuu*nuunn%%nnun% 

.macro PopB dest 

pia jpreleva il byte dallo stack 

sta dest je lo salva 

.endm 
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; Pop Wordi 

Popi"! dest 


/ 

; Argomenti; 

dest 

locazione alla quale memorizzare 
la word prelevata dallo stack 

f 

! Funzione; 

Preleva una 

word dallo stack 

j 

,macro PopW dest 

pia ;preleva il byte basso della uord 

sta 

pia 

dest + 0 

;e lo memorizza 

^preleva il byte alto della uiord 

sta 

.endm 

dest + 1 

je lo memorizza 


j Branch Relative fllwaysi bra addr 

j Argomenti I addr indirizzo al quale spostare il controllo 

f 

; Funzionei Effettua un branch incondizionato, Rispetto all'istruzione jmp, questa 

; macro presenta il vantaggio di essere perfettamente rilocabile 

J 


macro bra 

addr 

clv 


bvc 

addr 


.endm 
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; utuutuuutunuuunuuuuuuuuuntutunuttunuttuttuttttuuntuuu 


i Set Bit: 

smb bitNumero, dest 


f 

j Argomenti; 

) 

bitNumero 

numero del bit che deve essere impostato a 1 (7 per 
USO, 0 per LSD) 

t 

> 

dest 

indirizzo del byte che contiene il bit da 
impostare a 1 

f 

) Funzione; 

Imposta a 1 il bit 
l'accumulatore 

indicato. La versione piu' veloce (smbf) non preserva 

f 

; XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXiXXXXXXXXXXXiXXXXXXXXXXXXXXXXXXXXXiXXXXXXX 

.macro smb 

bitNumero, dest 


pha 



Ida 

#<l«bitNumero) 


ora 

dest 


sta 

dest 


pia 



.endm 



■macro smbf 

bitNumero, dest 


Ida 

#<l«bitNufflero) 


ora 

dest 


sta 

dest 



.endiA 


t 

; Reset Bit; rmb bitHumero, dest 

i 

; flrgomentii bitNumero numero del bit che dev'essere impostato a 0 <7 per 

; MSD, 0 per LSD) 

; dest indirizzo del byte che contiene il bit da 

; impostare a 0 

j Funzione: Imposta a 0 il bit indicato, La versione veloce (rmbf) non preserva 

; l'accumulatore 
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.macro 

rmb 

pha 

bitNuaero, dest 


Ida 

#(l«bitNumero) 


and 

dest 

.endm 

sta 

pia 

dest 

.macro 

rmbf 

BitNuaero, dest 


Ida 

#(l«bitNuBero) 


and 

dest 

.endm 

sta 

dest 




} Brandi on Bit Set: 


bbs bitNunero, sorg, addr 


1 Rrgotentii bitHumero 

> 

ì sorg 

; 

; addr 


numero del bit del byte che dev'essere 
controllato <7 per MSDj 0 per LSD) 
indirizzo del byte che contiene il bit da 
controllare 

indirizzo al quale saltare se il bit e' 
impostato a 1 


1 Funzione: Controlla il bit nel byte sorg, salta se e' impostato a 1, La versione 

; veloce (bbsf) non preserva 1'accumulatore 


; ntmnmmmttttmttnntntnnttumnummnnmmumnnnmmmtnu 


.aacro bbs 

bitNuaero, sorg. 

php 


pha 


Ida 

sorg 

and 

#<l«bitNuBero) 

beq 

noBranch 

pia 


plp 


bra 

addr 


noBranch: 

pia 

plp 


.enda 




558 


GUIDA UFFICIALE ALLA PROGRAMMAZIONE DI GEOS 


bbsf 

bitNumero, sorg, addr 

itNumero = 

7) 

bit 

sorg 

bmi 

addr 

(bitNumero 

= 6) 

bit 

sorg 

bvs 

addr 

Ida 

sorg 

and 

#(l«bitNumber) 

bne 

addr 


.endif 

.endm 




; Branch on Bit Reset; bbr bitHuntero, sorg, addr 


j Argomenti; bitNumero 

/ 

; sorg 

f 

; addr 


numero del bit del byte che dev'essere controllato 

(7 per USD, 0 per LSD) 

indirizzo del bgte che contiene il bit da 

controllare 

indirizzo al quale saltare se il bit e' 
impostato a 0 


; Funzione; Controlla il bit nel byte sorg, salta se e' impostato a 0. La versione 

i veloce (bbrf) non preserva l'accumulatore 




•macro bbr 

bitNumero, sorg. 

Php 


pha 


Ida 

sorg 

and 

#(l«bitNumero) 

bne 

noBranch 

pia 


plp 


bra 

addr 


noBranch; 

pia 
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plp 

.endm 

.macro bbrf 

bit 

bpl 

• elif 

bit 

bit 

. else 

Ida 

and 

be<i 

• endif 
.endm 


bitNumero, 

(bitNuKiero 

sorg 

addr 

<bitNumero 

sorg 

addr 


sorg, addr 
= 7) 

= 6 ) 


sorg 

#(1 «bit Numero) 
addr 




; Increment Wordi IncW addr 


j Argomenti; 

addr 

indirizzo della word da incrementare 

t 

; Funzione; 

IneW incrementa 

una uord, e restituisce il flag zero (Z) impostato a 1 

} 

se la uord vale 

e 

} 

.macro IncM 

addr 


ine 

addr 

; incrementa il bgte basso della uord 

bne 

done 

;se diverso da zero il byte alto va bene 

ine 

addr + 1 

;altrimenti incrementa il byte alto 


done; 

, endm 
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1 mmmmmmmmmmmmmmmmmmmmmmtmtmmmmmmt 


; Negate Mordi 

i Argomenti! 

j 

; Funzione! 


NegateH wordaddr 

wordaddr indirizzo della word che dev'essere negata 

Nega la word puntata da wordaddr 


; mmmmmmmmmmtmmmmmmmmmmmtmmmmmmmmt 


.macro NegateH wordaddr 

Idx #uordaddr 

jsr Dnegate 

.endm 


jpassa l'indirizzo della word da negare 
jchiama la routine del Kernel 





E APPENDICE E: 

I EORMATI DEI FILE 


Una panoramica 

In questa appendice si descrive il formato dei dati di alcuni particolari file (Text 
Scrap, Photo Scrap e tutti quelli generati da geoWrite). I file Text Scrap e Photo Scrap 
sono stati realizzati per consentire alle appUcazioni il reciproco scambio di dati grafici 
e testi. Vediamo brevemente la loro utilità. Quando l’utente attiva l’operazione cut 
(taglia) o copy (copia), durante l’esecuzione di un’applicazione, un file Photo Scrap o 
Text Scrap viene opportunamente creato su disco. Questo file è del tipo SYSTEM ed 
è a struttura SEQUENTIAL. L’utente può quindi mandare in esecuzione un’altra 
applicazione e attivare l’operazione paste (incolla) per trasferire i dati contenuti nel file 
Scrap all’interno del nuovo documento. I file Scrap possono essere anche collezionati 
in “album” tramite i desk accessory Photo Manager e Text Manager. 

Il formato di output su disco adottato da geoWrite è importante per i progranunatori 
che desiderano realizzare appUcazioni in grado di creare file in quel formato, o leggere 
i documenti di geoWrite. 

La prima parte di questa appendice illustra il formato per i file Photo Scrap; la 
seconda parte il formato per i file Text Scrap; la terza parte il formato utilizzato da 
geoWrite. 


Versioni future 

I formati per i file Photo Scrap e Text Scrap si sono già evoluti rispetto alle prime 
versioni, e probabilmente subiranno altri miglioramenti in futuro. Per evitare problemi 
di compatibilità, le applicazioni devono controllare la versione del formato, 
memorizzata nel File Header del file, prima di procedere all’elaborazione dei dati. Il 
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controllo della stringa versione di un file è ampiamente discusso nel capitolo dedicato 
al sistema dei file in ambiente GEOS. I byte in posizione 89 - 92 (decimali) del blocco 
File Header, contengono la stringa ASCII della versione, per esempio Vl.l o 
successive. La versione 1.1 indica il primo formato generale che è stato impiegato per 
i file di dati. 

Se il file Scrap è in un formato meno recente di quelli che l’applicazione è in grado 
d’interpretare, dev’essere convertito. In genere le applicazioni dovrebbero essere in 
grado di fare questa conversione, ed essere quindi compatibili con tutti i file dati creati 
in precedenza. Se il formato dei dati contenuti nel file è più recente di quello adottato 
dall’applicazione, questa dovrebbe rinunciare all’elaborazione dei dati. 


Photo Scrap 

Attualmente i file Photo Scrap sono in grado di contenere una sola mappa grafica 
in bit-map. Una mappa grafica è una struttura che GEOS utilizza per contenere dati 
grafici in bit-map compattati. La compattazione dei dati grafici e le mappe grafiche 
sono argomenti che abbiamo affrontato nel capitolo 4. Il file Photo Scrap non è altro 
che una mappa grafica in bit-map, con allegata una tavola di colori. 

Nel formato ottenuto dopo l’espansione dei dati, ogni byte della tavola di colori 
contiene informazioni sul colore di ogni matrice grafica di cui è composta la mappa 
scompattata. La tavola di colori si ottiene accedendo al buffet da 1000 byte che GEOS 
usa per 1 colori delle matrici grafiche per lo schermo in alta risoluzione. Come abbiamo 
già spiegato nel corso del libro, con il termine “matrice grafica” intendiamo una 
matrice di 8 x 8 pixel (quando non altrimenti specificato) che dev’essere allineata con 
gli spazi carattere dello schermo in bassa risoluzione. 

Nel modo in alta risoluzione bit-map del C-64, una matrice grafica occupa 8 byte e 
definisce un quadrato di 8 x 8 pixel. A ogni matrice è associato un byte che ne definisce 
il colore. Per esempio, il primo byte della pagina di colori determina il colore della 
prima matrice grafica sullo schermo. Il secondo byte determina il colore della seconda 
matrice grafica, e così via. Nella tavola della pagina successiva è illustrata questa 
corrispondenza. 
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Matrice 0 Matrice 1 Matrice 2 Matrice 3 


byte 

byte 

byte 

byte 

byte 

byte 

byte 

byte 



^ Le rimanenti righe grafiche 3 - 24 

Organizzazione dei byte su uno schermo in bit-map 


Le mappe grafiche memorizzate nei file Photo Scrap non sono limitate alle 
dimensioni dello schermo. Mentre la maggior parte delle applicazioni creano file Scrap 
di dimensioni inferiori a quelle dello schermo, possono ugualmente essere create e 
salvate mappa grafiche anche molto più grandi. La tavola di colori e la mappa grafica 
possono essere indifferentemente più piccole o più grandi dello schermo in alta 
risoluzione. 

Il formato dei dati per un file Photo Scrap prevede che i primi tre byte che precedono 
il primo gruppo grafico individuino le dimensioni della mappa grafica. Più 
precisamente, il primo byte indica la larghezza della mappa grafica in byte, e i due byte 
successivi indicano l’altezza espressa in linee di scansione. Moltiplicando tra loro le 
due dimensioni si ottiene l’esatto numero di byte generato dall’espansione di tutti i 
gruppi grafici. L’altezza dev’essere sempre un multiplo di 8, dal momento che le 
operazioni cut e copy hanno effetto solo su matrici grafiche intere. La larghezza della 
mappa è sempre espressa in matrici complete. Queste restrizioni sono necessarie 
perché ogni byte del colore corrisponde a un’intera matrice grafica. 

La tavola dei colori viene compattata come le mappe grafiche. Quindi anch’essa 
appare nel file Photo Scrap come una serie di gruppi grafici da espandere. Il primo 
gruppo grafico della tavola dei colori inizia subito dopo l’ultimo gruppo grafico della 
mappa in bit-map. Quando il previsto numero di byte grafici è stato espanso, il gruppo 
grafico successivo corrisponde all’inizio della tavola dei colori compattata. Il numero 
di byte della mappa grafica diviso per 8 individua il numero di byte di cui è composta 
la tavola dei colori. La tavola della pagina successiva illustra la struttura di un file 
Photo Scrap. 
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Formato dei dati in un file Photo Scrap 


Byte 

Contenuto 

0 

Larghezza in byte della mappa grafica in bit-map 

1-2 

filtezza in linee di scansione della nappa grafica in bit-map 

3 

Byte di conteggio del primo gruppo grafico. GEOS prevede tre 
diversi formati per i gruppi grafici, La loro attivazione 
dipende dal valore contenuto nel byte di conteggio: 

0-127 ripeti il prossimo byte COUNT volte 

128-220 scrivi una sola volta, nell'ordine, i seguenti 
(C0UNT-128> byte (straight bit-map) 

221-255 utilizza il byte che segue come BIGCOUNT, 

e ripete i seguenti (COUNT-220) byte BIGCOUNT volte 

4-fine gruppo 

Dati del gruppo grafico in uno dei tre metodi 

grafico 

di compattazione 

Count 

Byte di conteggio del successivo gruppo grafico 

Dati bit-map 
filtri gruppi grafici 

Dati del gruppo grafico 

Tavola Colore 

Tavola dei colori memorizzata in modo compattato 


Per riassumere, un file Photo Scrap è composto dai tre byte delle due dimensioni, 
seguiti dalla mappa grafica compattata e dalla tavola dei colori. Sia la mappa grafica 
sia la tavola dei colori sono composte da gruppi grafici sequenziali. I gruppo grafici 
possono adottare uno qualsiasi dei tre formati di compattazione di cui dispone GEOS. 
Un gruppo grafico è composto dal byte di conteggio (Count Byte) che ne individua il 
formato di compattazione e il parametro di conteggio, seguito da una serie di byte che 
dipendono dal tipo di compattazione. Come è già stato descritto nel capitolo dedicato 
alla grafica, dopo l’espansione le mappe grafiche in bit-map devono essere riordinate 
in linee di scansione a matrici grafiche. La tavola dei colori contiene, in formato 
compatto, i colori della mappa grafica. Ogni byte della tavola individua il colore della 
conispondente matrice grafica 8x8 pixel memorizzata nella mappa grafica. 

Text Scrap VI.2 

Questo paragrafo descrive il formato dei file Text Scrap V1.2. La versione 2.0 è un 
ampliamento della versione 1.2. L'unica vera differenza consiste nella riga di 
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definizione (miei) piesente nei file Photo Sciap V2.0, che saià ilhistiata nei piossimi 
paiagiafi. 

Un file Text Sciap è una stringa ASCII contenente alcuni caiatteii di contiollo. I 
caiatteii di controllo sono facilmente individuabifi in quanto non sono stampabili come 
codici ASCII(t). Nei file Text Sciap sono utilizzati due paiticolaii caiatteii di controllo. 
Il primo è il TAB (codice $09). Sta alla paiticolaie applicazione rendere disponibili i 
caratteri tabulatori. Il secondo è individuato dalla costante NEWCARDSET (23). 
Questa segnala all’applicazione l’inizio di una stringa di 4 byte per la gestione delle 
fonti e degli stili. I primi due byte dopo NEWCARDSET caratterizzano la fonte che 
dev’essere utilizzata per visualizzare il testo che segue. L’ultimo byte della stringa 
(style byte) indica lo stile che dev’essere impiegato: tondo (plaintext), nero (bold), 
corsivo (italic), sottolineato (underline) e outline. Ogni stile è controllato da un bit 
dello style byte. Impostando, per esempio, il bit “nero", il testo viene visualizzato con 
lo stile nero. Nella tavola successiva è illustrato il significato di ogni bit. 

Nel testo appare una completa stringa NEWCARDSET ogni volta che si richiede un 
cambiamento nella fonte e/o nello stile. L’accessorio da scrivania Text Manager non 
visualizza le tabulazioni, i cambiamenti di stile e di fonte, ma questi caratteri di 
controllo sono ugualmente presenti nel file Text Scrap. Le applicazioni devono essere 
in grado di gestire anche i caratteri di controllo presenti aU’interno di un file Text 
Scrap, oltre a quelli ASCII. Vediamo ora la struttura di un file Text Scrap. 


Text Scrap 

Il file Text Scrap, come appare in memoria, inizia con due byte che indicano il 
numero totale di byte che seguono (esclusi i primi due). Subito dopo segue una stringa 
NEWCARDSET. 

La stringa di controllo è lunga quattro byte e inizia con il carattere di controllo 
NEWCARDSET. I due byte successivi costituiscono l’identificatore del set di caratteri 
selezionato (Font ID). 16 bit più bassi di questa word specificano il corpo del carattere 
(point size). 110 bit più alti specificano il numero di identificazione unico della fonte. 
La word del Font ID è seguita dallo style byte, aU’interno del quale ogni bit controlla 
un particolare stile. Impostando un bit aU’interno dello style byte, si attiva lo stile 
corrispondente. Cancellandolo, si ottiene la disattivazione dello stile. Se tutti i bit dello 
style byte sono azzerati, è attivato lo stile tondo (plain text). Per uno schematico quadro 
riassuntivo si può consultare la tavola della pagina successiva. 


(t) In ASCII il set di caiatteii stampabili inizia con il caiatteie spazio (SPACE) al quale conisponde il codice 
$20. I piimi 32 caiatteii ASCII (dal codice $00 al codice $1F) non sono stampabili in quanto non 
coiiispondono né a lettere né a numeri, e spesso vengono impiegati come caiatteii di contiollo airintemo 
delle stiinghe di testo. 
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Formato dei file Text Scrap 


Contenuto Commento 


Lunghezza 

NEWCflRDSET 

Font ID 


Style Byte 


6-fine 
file 


Numero di byte che seguono nel file 

Carattere di controllo per la selezione della fonte 

e dello stile (codice 23) 

Indicatore della fonte e del set. 16 bit piu' 
bassi specificano il corpo (il set)^ mentre i 10 piu' 
alti specificano l'identificatore unico della fonte 
che dev'essere attivata 


Costante 

Valore 

Funzione 

SET-UNDERLINE 

X10000000 

Bit 7 = li 

attiva 

sottolineato 

SET-BOLD 

X01000000 

Bit 6=1: 

attiva nero 

SET-RE')ERSE 

X00100000 

Bit 5=1: 
attiva negativo 

SET-ITALIC 

X00010000 

Bit 4 = 1 

attiva corsivo 

SET.OUTLINE 

X00001000 

Bit 3 = li 
attiva outline 

SET-SUPERSCRIPT 

X00000100 

Bit 2=1: 
attiva gli indici 
all'apice 

SET-SUBSCRIPT 

X00000010 

Bit 1 = li 
attiva gli indici 
al pedice 

SET-PLAINTEXT 

X00000000 

Tutti i Bit a 0: 

attiva tondo 


Stringa di testo 


La stringa ASCII contenente i caratteri di controllo 
(TAB e NEWCAROSET), e, se V2.0, la riga di definizione 
(ruler) 
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Il lesto della stringa è composta da testo, caratteri TAB e altre eventuali stringhe 
NEWCARDSET. Non è previsto un particolare carattere che segnali la fine del testo, 
e quindi le applicazioni che accedono a file Scrap di testo devono confrontare il numero 
di caratteri letti con il totale indicato dai primi due byte dei ffie. 

La tavola che segue riassume schematicamente le fonti carattere attualmente 
disponibili su GEOS. Le fonti per geoLaser sono state realizzate in modo tale da 
riprodurre, per quanto possibile, i caratteri della stampante laser Apple LaserWriter. 

Per riassumere, un file Text Scrap inizia con una word che indica la lunghezza del 
testo (word esclusa), seguita da una stringa di controllo iniziale (NEWCARDSET) per 
la selezione delle fonti e degli stili. Solo allora inizia il testo vero e proprio, che a sua 
volta può contenere il carattere di controllo TAB e le stringhe NEWCARDSET. Questo 
è il formato utilizzato nei file Text Scrap VI.2 


Le fonti carattere di GEOS 

Nome 

identificatore Corpo 

Word 

fonte 

(10 bit più alti) (6 bit più bassi) 

Font ID 

BSU 

e 

9 

100 09 

University 

1 

6 

$00 46 



10 

$00 4R 



12 

$00 4C 



14 

$00 4E 



18 

$00 52 



24 

$00 58 

California 

2 

10 

$00 8R 



12 

$00 8C 



13 

$00 SD 



14 

$00 8E 



18 

$00 92 

Roita 

3 

9 

$00 C9 



12 

$00 CC 



18 

$00 D2 



24 

$00 06 

Duinelle 

4 

18 

$01 12 

Cory 

5 

12 

$01 4C 



13 

$01 4D 
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Le fonti dalla 6 alla 25 risiedono nel disco GEOS Font Pack 1 

Nome 

identificatore 

Corpo 

Word 

fonte 

(10 bit più aiti) 

(6 bit più baasi) 

Font ÌD 

Tolman 

6 

12 

101 8C 



24 

$01 98 

Bubble 

7 

24 

101 D8 

FontKiìox 

8 

24 

$02 18 

HariKon 

9 

10 

$02 4fl 



20 

$02 54 

Mykonos 

10 

12 

$02 8C 



24 

$02 98 

Boalt 

11 

12 

$02 CC 



24 

$02 08 

Stadium 

12 

12 

$02 30 

Tilden 

13 

12 

$03 CC 



24 

$03 4C 

Evans 

14 

18 

$03 92 

Durrant 

15 

10 

$03 Cfl 



12 

$03 CC 



18 

$03 02 



24 

$03 08 

Telegraph 

16 

18 

$04 12 

Superb 

17 

24 

$04 58 

Bowditch 

18 

12 

$04 8C 



24 

$04 08 

Ormand 

19 

12 

$04 CC 



24 

$04 98 

Elmuood 

20 

18 

$05 12 



36 

$05 24 

Hearst 

21 

10 

$05 4R 



12 

$05 4C 



18 

$05 52 



24 

$05 58 

Brennens 

22 

18 

$05 92 

Channing 

23 

14 

$05 CE 



16 

$05 00 



24 

$05 08 

Pulnami 

24 

12 

$06 0C 



24 

$06 18 

LeConte 

25 

12 

$06 4C 



18 

$06 52 
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Fonti per geoLaser 


Nome 

Identificatore 

Corpo 

Word 

fonte 

(10 bn più alti) 

(6 bit più bassi) 

Font ID 

Commodore 

26 

10 

$06 8R 

LM-Roma 

27 

9 

$06 C9 



10 

$06 Cfl 



12 

$06 CC 



14 

$06 CE 



18 

$06 02 



24 

$06 08 

LW-Cal 

28 

9 

$07 09 



10 

$07 0fl 



12 

$07 0C 



14 

$87 8E 



18 

$07 12 



24 

$07 18 

LW-Greek 

29 

9 

$07 49 



10 

$07 4fl 



12 

$07 4C 



14 

$07 4E 



18 

$07 52 



24 

$07 58 

LU-Barrous 

30 

9 

$07 89 



10 

$07 3fl 



12 

$07 8C 



14 

$07 8E 



18 

$07 92 



24 

$07 98 


La riga di definizione V2.0 

Nella versione 2.0 dei file Text Scrap è stata aggiunta la riga di definizione (ruler) 
del testo, per mantenere la compatibilità con il formato geoWrite. In particolare, con 
la versione 2.0 di geoWrite è diventato possibile inserire più funzioni di giustificazione 
e di cambio margini all'interno di una stessa pagina (cioè più righe di definizione 
aH’interno della stessa pagina). La riga di definizione è una struttura invisibile 
aH’utente, generata dall’applicazione per memorizzare lungo il testo parametri 
fondamentali come i margini, la presenza di tabulatori e così via. Questa riga non deve 
necessariamente apparire nel corso del testo, ma, se viene introdotta, la sua posizione 
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è condizionata a particolari aree. Più precisamente, la riga di definizione può apparire 
solo all’inizio del file o aU’inizio di un paragrafo. I paragrafi sono individuati nel testo 
dalla presenza dei caratteri CR (ritorno carrello), e quindi una riga grafica dev'essere 
sempre anteposta al carattere CR che termina il paragrafo precedente. Le righe 
grafiche sono lunghe 27 byte, e contengono informazioni sui margini del documento, 
la giustificazione dei paragrafi, i colori (se disponibili) e così via. 

Anche se nelle righe di definizione del testo sono specificate le tabulazioni, 
l’accessorio da scrivania Text Manager non le interpreta. Se l’applicazione prevede le 
tabulazioni, quando incontra nel testo il carattere TAB deve spostare il cursore alla 
colonna di tabulazione specificata dall’ultima riga di definizione incontrata. Se a 
destra del cursore non è stata impostata nessuna tabulazione, il cursore viene spostato 
a riga nuova. La tavola che segue illustra il formato V2.0 della riga di definizione. 


Formato V2.0 della riga di definizione 


Byte 

Contenuto 

Descrizione 


1 

ESC-RULER 

Indica l'inizio 

della riga di definizione 

2 - 3 

Left Margin 

Margine sinistro 

espresso in pixel (0 - 319) 

4 - 5 

Right Margin 

Margine destro espresso in pixel 
(Left Margin<Right Margin<319) 

6 - 21 

Tabulatori 

Ogni tabulazione 
per 8 tabulatori 

occupa una word, 3 word totali 



Bit 15 

Impostato a 1 tabulatore 
decimale, allineamento 
decimale dei punti 

Impostato a 0 tabulatore 
normale nel testo 



Bit 14-0 

Posizione del tabulatore 
(tabulatore<Right Margin) 

22 - 23 

Rientranza 

Distanza dal margine sinistro da impostare 



all'inizio di un 

nuovo paragrafo (0 - 319) 

24 

Giustificazione 

Bit per la giustificazione e l'interlinea 



Bit 1 Bit 0 

0 0 

testo allineato a sinistra 



0 1 

testo centrato 



1 0 

testo allineato a destra 



1 1 

testo allineato a sinistra 

e a destra 




SEGUE 
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SEGUE 


Bit 3 Bit 2 

0 0 

interlinea di 1 riga 



0 1 

interlinea di 1,5 righe 



1 0 

interlinea di 2 righe 

25 

Colore del testo 

Colore del testo, 

Attualmente nessuna 



applicazione GEOS 

utilizza questo byte 

26 - 27 

Riservati 

Byte riservati per 

impieghi futuri 


Formato dei file generati da geoWrite 

Come avviene per i file Text Scrap, anche per i file generati da geoWrite esistono 
due formati; il formato Vl.l e il formato V2.0.1 numeri di versione dei formati di output 
non corrispondono ai numeri delle varie versioni di geoWrite. Mentre per geoWrite 
esistono le versioni 1.1, 1.2, 1.3 e 2.0, i formati di output hanno solo la versione 1.1 e 
la 2.0. 

In entrambi i formati di output, i documenti sono memorizzati in file a struttura VLIR. 
In generale, ogni record del file contiene i dati di una pagina di testo. Alcuni record 
sono utilizzati per le figure grafiche e, nel caso dei file in formato V2.0, per le 
informazioni relative alla nota di fine pagina e all’intestazione. La tavola che segue 
mostra l’organizzazione complessiva di questa struttura. 


Formato dei file VLIR generati da geoWrite 



Numero 

Formato V1.1 dei File 

Formato V2.0 dei File 

dei record 



0 - 60 

Pagine di testo 

Pagine di testo 

61 

Pagine di testo 

Intestazione, vuoto in assenza di testo 

62 

Pagine di testo 

Nota a fine pagina, vuoto in assenza di testo 

63 

Pagine di testo 

Riservato 

64 - 127 

Figure in formato BitmapUp 

Figure in formato BitmapUp 
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La principale differenza fra il formato VI. 1 e il formato V2.0 consiste nella gestione 
deU’intestazione e della nota a fine pagina messe a disposizione da Writer’s Workshop 
V2.0. Le pagine 61 - 63 possono essere impiegate per memorizzare testi, come avviene 
con geoWrite V1.2 e VI.3, ma se il documento viene in seguito modificato con geoWrite 
V2.0, queste pagine non vengono considerate. Questo limite nella compatibilità tra i 
due formati non dovrebbe comunque costituire un problema, soprattutto se si 
considera che nessuno ha mai memorizzato un file testo di 61 pagine in un disco del 
1541. Quando sarà disponibile la gestione della doppia faccia sul 1571, questo 
problema potrebbe ripresentarsi. 

In geoWrite, ogni documento è suddiviso in pagine separate, e ogni pagina viene 
memorizzata in un record della struttura VLIR del file. Una pagina consiste in una riga 
di definizione seguita dal testo. Nei file in formato Vl.l, prodotti dalle versioni 1.2 e 
1.3 di geoWrite, la riga di definizione include soltanto l’indicazione dei margini e dei 
tabulatori. 


Formato V1.1 di una pagina di geoWrite 


Byte Contenuto Descrizione 


2 - 


20 - 
24 - 


1 

3 

19 

■ 23 

9 


Ultimo 

byte 


Left tlargin 
Right Margin 
Tabulatori 

NEWCfìRDSET 
Testo e Grafica 


EOF = 1 


Coordinata in pixel del margine sinistro 

Coordinata in pixel del margine destro 

Rrray da 8 uord ognuna delle quali contiene una 

coordinata in pixel del tabulatore 

Stringa di selezione delle fonti e degli stili 

Testo della pagina. Può' contenere cambi di fonte e 

di stile, indicatori di inserimenti grafici e 

identificatori di fine pagina 

PflCE-BREflK = 1 geoWrite considera conclusa la 

pagina corrente e inizia a scrivere 
in quella successiva 

ESC-GRflPHlCS « 16 Carattere di controllo per 
l'inserimento di una figura 

Marcatore di fine pagina 
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Il testo che segue la prima strihga NEWCARDSET è memorizzato in ASCII. Le 
stringhe di controllo vengono utilizzate per i cambi di fonte e di stile, e per includere 
le figure grafiche. I dati grafici di ogni figura sono memorizzati in record separati. Tutte 
le pagine non vuote devono iniziare con la stringa di controllo NEWCARDSET. Due 
stringhe di questo tipo non possono essere consecutive. 

Airinterno di un testo possono essere presenti alcune figure: geoWrite segnala il 
punto d’inserimento tramite il carattere ESC-GRAPHICS, e memorizza i dati della 
figura, sotto forma di mappa grafica, in un particolare record. Per informazioni più 
dettagliate sulle mappe grafiche in ambiente GEOS si consulti il capitolo 4. 


Strìnga grafica di controllo 


Byte 

Funzione 

Descrizione 

e 

ESC-GRfìPHICS 

Carattere che segnala la presenza di un stringa 
di controllo (codice $18) 

1 

Larghezza 

Larghezza del disegno in matrici grafiche 

2 - 3 

Rltezza 

Rltezza del disegno in linee di scansione 

5 

Nuntero del record 

Numero del record contenente i dati grafici del 
disegno inserito nel testo. Il disegno dev'essere 
stato prelevato da un file Photo Scrap 


geoWrite V2.0 

La versione 2.0 di geoWrite, dal punto di vista dell'output su file, è simile alla 
versione 1.2, ma mette a disposizione una riga di definizione più ricca di informazioni, 
con una struttura analoga a quella utilizzata nei file Text Scrap. Il formato di una 
pagina generata da geoWrite V2.0 è illustrato nella tavola che segue. 
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0 - 27 Stringa della riga di definizione V2,0 del testo 

28 - 31 NEHCflROSET (23) per il cambio della fonte e dello stile 

32 - ? Testo del documento. Può' contenere altre righe di definizione, 

cambi di fonte e di stile, disegni e interruzioni di pagina 
PflGE-BREflK =1 Conclude la pagina corrente e ne inizia una nuova 

ESC-GRfiPHICS = 16 Inizio di un disegno 
Ultimo byte EOF = 0 Marcatore di fine file 


Nel fonnato V2.0 ulteriori informazioni sono immagazzinate nel blocco File Header 
del file di testo. Per esempio l’altezza dell’intestazione e della nota a fine pagina, 
l’altezza di una pagina del testo (questo valore dipende dal tipo di stampante 
adottata), e alcuni flag per il modo NLQ e la titolazione. 


Informazioni nel File Header dei file V2.Ò 


Byte Contenuto Descrizione 

137 - 138 Numero prima pagina Numero che si assegna alla prima pagina 

(non dev'essere necessariamente 1) 

139 Titolo e NLQ Bit 7 impostato a li la prima pagina contiene 

il titolo e dev'essere stampata senza 
intestazione ne' nota di fine pagina 
Bit 6 impostato a li la stampa può' essere 
effettuata solo in modo NLQ 

140 - 141 Altezza dell ' intestazione Altezza in pixel che dev'essere riservata su 

ogni pagina per l'intestazione 

142 - 143 Altezza della nota di Altezza in pixel che dev'essere riservata su 
fine pagina ogni pagina per la nota di fine pagina 

144 - 145 Altezza della pagina Stampanti diverse supportano diverse 

risoluzioni verticali. Se l'altezza della pagi¬ 
na memorizzata in questa word non corrisponde 
a quella imposta dalla stampante, geoUrite 
V2.0 riformatta il file per renderlo compatibile 
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Riepilogo su geoWrite 

I documenti generati da geoWrite vengono salvati in file a struttura VLIR. Ogni 
pagina viene memorizzata su disco aU’interno di un opportuno record. Alcuni record 
del file possono anche contenere i dati per i disegni da inserire nel testo. Oltre a questo, 
geoWrite V2.0 aggiunge la possibilità di definire un’intestazione, una nota a fine 
pagina, il tipo di giustificazione, il tipo d’interlinea, il modo NLQ e la pagina di 
copertina priva d’intestazioni. Nella versione 1.1 dei file la riga di definizione ha una 
struttura relativamente semplice e può trovarsi solo all’inizio della pagina. Nella 
versione 2.0 la riga grafica può essere inserita all’inizio di ogni paragrafo e contiene 
un numero maggiore di informazioni. 

Questa panoramica sulle caratteristiche di geoWrite nelle sue diverse versioni 
dovrebbe essere sufficiente per leggere e creare file in uno qualsiasi dei formati 
disponibili. I programmatori, durante la realizzazione di un’applicazione, devono 
sempre tener presente che le nuove versioni sono espansioni delle precedenti e quindi 
non creemo problemi di compatibilità. Per esempio, i file Text Scrap Vl.l possono 
essere letti dall’ultima versione di Text Manager. L’unica possibile incompatibilità fra 
i formati può verificarsi nel caso che geoWrite VI.2, o VI.3, salvi su disco un file tanto 
grande (più di 60 pagine) da occupare i record che geoWrite V2.0 utilizza per 
l’intestazione e la nota a fine pagina. Ma questa condizione non dovrebbe verificarsi 
mai, dal momento che è improbabile che un documento di oltre 60 pagine venga 
salvato su un solo disco. 

I file Text Scrap e geoWrite differiscono soltanto per quanto riguarda la lunghezza: 
i file Text Scrap vengono salvati in file SEQUENTIAL e quindi al massimo possono 
raggiungere la lunghezza di vma pagina. Si prestano quindi a essere utilizzati per la 
comunicazione tra due word processor. 
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Indice delle routine 


Per argomenti 

Bos di dialogo 

DoDlgBox, 235, 253 
RstiFrmDialogue, 235*236, 254 

Driver di input 

C64-Joystick. 182-183 
CleaiMouseMode, 162,164 
ComputeMouseVels, 179 
InitMouee, 151-152. 173 
IsMselnHegìon, 167, 168 
MouseOff, 162, 165-1^6 
MouseUp, 61, 162, 165-166 
SineCosine, 164 

SiowMouse. 151,153, 155-156, 174 
StartMouseMode, 162, 163, 164 
UpdateMouse, 151, 157-158, 175 
UpdateMouseVels, 177 
UpdateMouseX, 180 
UpdateMouseY, 176 

Driver di stampa 

BotRoUBuffei, 429-432, 449 
CloseFUe, 425 
ClosePrint, 427 
FonnFeed, 421, 458 
GetDimensìons, 387, 394. 404, 442 
Gretum, 420, 457 
InitFoxPrint, 387, 393 
InitPiìntei, 416 
OpenFUe, 424 
OpenPrint, 426 
PrintASCn, 400. 409, 444 
PrintBuffei, 389, 396, 410. 438 
PhntPrintBufiei, 389, 412, 446 
RoUSbyt^In, 453 
RoUSbytesOut, 454 
RoUaCaid, 429, 450 
Rotate 422, 459 
SendBuff, 419, 456 
SetGxaphics, 417, 455 
SetNLQ, 389, 408 
StartASCn. 389-399, 407, 443 
StartPrint, 387. 395, 405, 436 
StopPrint, 388. 398, 411, 440 
Stiout, 428 
TestBuffer, 414, 451 
TopRoUBufier, 429-432, 448 
UnSetGraphics, 455 

Eqpansiani RAM 

DoRAMOp. 478 
FetchRAM, 475 
StashRAM, 474 
SwapRAM, 476 
VerifyRAM, 477 

FUeVUR 

AppendRecord, 380 
CloseRecoidFile, 371 
DeleteRecord, 375 
InsertRecord, 379 


NextRecoid, 373 
OpenRecordFile, 146, 369, 370 
PointRecord, 373 
PreviousRecord, 373 
ReadRecord, 378 
UpdateRecoidFile, 372 
WriteRecord. 376 

Fonti carattere 

LoadCharSet, 118,145-147 
UseSystemFont, 118, 145,148 

Grafica 

BitmapCUp, 101, 102 
BìtmapUp, 100 
BitOtherCIip, 103, 104 
DrawUne, 84 
DrawPoint, 78, 84 
FiameRectangle, 90, 91 
GetScanLine. 110 
GraphicsString. 106, 107 
HorizontalLine, 80, 90 
ImprintRectangle, 83. 95 
InvertLine, 82, 93 
InveitRectangle, 30, 93 
j-BitmapUp. 100 
ìJF'TameRectangle, 91 
UGraphicsStiing, 107 
i_ImprintRectangle. 95 
i_RecovorRectangle, 94 
i-Rectangle, 11, 25, 27, 61, 86, 89 
RocoverLine, 14, 83 
RecoverRectangle, 14, 75, 94-95, 247 
Rectangle, 11, 80-81, 88-89, 92 
SetNewMode, 480 
SetPattern, 61, 86, 88 
TestPoint, 79 
VerticaiLine, 81 

Icone e mmin 

Dolcons, 25-31, 483 
DoMenu, 27. 39, 483-484 
DoPreviousMenu. 37, 41. 43 
GotoFirstMenu, 36-37, 42. 60 
RecovetAUMenus, 14, 44 
RecoveiMenu, 14. 43 
ReDoMenu, 40 

Libreria generale 

CallRoutine, 226 
ClearRam, 222 
CmpFString, 219 
CmpString, 218 
CopyFString, 217 
CopyString, 216 
CRC, 231 

DoInlineRetum, 232 
FillRam, 223 
Pirstlnit, 230, 461 
GetSerialNumbet. 227 
InitRam, 224 
i-FillRam, 223 
1-MoveData, 221 
MoveData, 221, 483 
Panie, 220 
ToBasic, 228 

libreria matamatica 

BBMult, 206 
BMult, 207 
Dabs, 211 


Ddec, 213 
Ddiv, 209 
DMult, 208 
Dnegate, 212 
DSdiv, 210 
DShiftLeft, 204 
DShiftRight, 205 
GetRandom, 214 

Processi ten^iorizzati 

BlockProcess, 198 
EnableProcess, 194, 202 
FreezePiocess, 199 
InitPiocesses, 196 
RestartProcess. 197 
Sleep, 195, 200 
UnblockProcess, 198 
UnfreezeProcess, 199 

StgtoTwn ilei fila 

BldGDiiEntry, 276, 342 
BìkAlloc, 276, 330 
CalcBlksFiee, 274, 301 
ChangeDiskDevlce, 276. 349 
ChkDkGEOS, 274, 284 
DeleteFile, 274. 297 
DoneWithlO. 19, 277. 353 
EnterDeskTop, 66. 274, 300 
EnterTuibo, 277, 356 
ExìtTurbo, 277, 358 
FastDelFile, 276, 345 
FindBAMBit, 276, 337 
FindFUe, 274, 293 
FindFTypes. 145, 274, 285 
FoUowChain, 276, 344 
FreeBIock, 24, 276, 338 
FreeFUe, 276, 347 
GetBlock, 275, 304 
GetDiiHead. 275, 315 
GetFHdrInfo, 275, 308 
GetFUe. 271, 274. 288 
GetFreeDiiBlk. 276, 328 
GetPtiCuiDkNm, 274, 282 
InitForlO, 19, 277, 352 
LdAppUc, 275, 318 
LdDeskAcc, 246, 271, 275. 324 
LdFile, 275, 322 
NewDisk, 61. 275, 317 
NxtBlkAUoc, 276, 333 
C^nDisk, 274, 281 
PurgeTuibo, 277, 354 
PutBlock, 275, 306 
PutDirHead, 275. 316, 481 
ReadBlock. 277, 359 
ReadByte, 105, 275, 313 
ReadFile, 275, 309 
RenameFile, 274, 299 
RstrAppl, 276, 327 
SaveFUe. 274, 295, 369 
SetDevice, 274, 280 
SetGDiiEntry, 276, 339 
SetGEOSDisk, 274, 283 
SetNextFree. 276, 335 
StaxtAppl, 276, 350, 461 
VerWriteBlock, 277, 363 
WriteBlock, 277. 361 
WriteFUe, 275, 311 

Zittite 

DisablSprite, 164, 187, 191 
DxawSprite, 187-188 
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EnablSprite, 190 
PosSpiite, 187, 189 

Testi 

GetCharWidth, 140 
GetNextChai, 5. 126, 132 
GetRealSìze, 130, 139 
GetString, 112. 120-122,125. 141 
InitTextPiompt, 128, 133-134 
LPutString, 112. 117 
PromptOff, 135 
PromptOn. 128,134 
PutChar. 113. 136. 141 
PutDecimal, 119 
PutString, 112, 117. 120. 125 
SmallPutChar. 138 


Alfabetico 

AppendRecord, 380 
BBMult, 206 
BitmapClip, 101, 102 
BitmapUp, 100 
BitOtherClip. 103. 104 
BldGDirEntry. 276. 342 
BlkAUoc. 276, 330 
BlockProcess, 198 
BMult, 207 

BotRollBuffer. 429-432, 449 
C64-Joystick, 182-183 
CalcBUcsFree, 274, 301 
CallRoutine, 226 
ChangeDiskDevice, 276, 349 
ChkDkGEOS, 274, 284 
CleaiMouseMode, 162, 164 
ClearRam, 222 
CloseFile, 425 
ClosePrint, 427 
CloseRecordFìie. 371 
CmpFString, 219 
CmpStnng, 218 
ComputeMouseVels, 179 
CopyFString, 217 
CopyStiing, 216 
CRC, 231 
Dabs, 211 
Ddec, 213 
Ddiv, 209 

DeleteFUe. 274. 297 
DeleteRecord, 375 
DisablSprite, 164, 187, 191 
DMult, 208 
Dnegate, 212 
DoDlgBox, 235, 253 
Dolcons. 25-31, 483 
DoInlineRetiun, 232 
DoMenu, 27, 39, 483-484 
DoneWithIO, 19. 277. 353 
DoPreviousMenu, 37, 41, 43 
DoRAMOp, 478 
DiawLine, 84 
DrawPoint, 78, 84 
DrawSprite, 187-188 
DSdiv, 210 
DShiftLeft. 204 
DShiftRight, 205 
EnableProcess, 194, 202 
EnablSprite. 190 
EnterDeskTop. 66. 274, 300 


EnterTuibo, 277, 356 
ExitTurbo, 277, 358 
FastDeìFile, 276. 345 
FetchRAM, 475 
FiURam, 223 
FindBAMBit, 276, 337 
FindFUe, 274, 293 
FindFTypes, 145, 274, 285 
Firstlnit, 230, 461 
FoUowChain. 276. 344 
FormFeed, 421, 458 
FiameRectajigle, 90, 91 
FieeBlock, 24. 276, 338 
FreeFile, 276, 347 
FreezeProcess, 199 
GetBlock, 275, 304 
GetCharWidth, 140 
GetDimensions, 387, 394, 404, 442 
GetDiiHead, 275, 315 
GetFHdrlnfo, 275, 308 
GetFile, 271, 274, 288 
GetFreeDirBlk, 276, 328 
GetNextChai, 5,126,132 
GetPtrCurDkNm, 274, 282 
GetRandom. 214 
GetReaìSize, 130, 139 
GetScanLine, 110 
GetSerialNumber. 227 
GetString. 112, 120-122,125, 141 
GotoFirstMenu, 36-37, 42, ^ 
GraphicsString, 106, 107 
Gretuin, 420, 457 
HoiizontalLine, 80, 90 
ImprintRectangle, 83, 95 
InitForlO. 19. 277, 352 
InitForPrint, 387, 393 
InitMouse. 151-152, 173 
InitPiinter, 416 
InitPiocesses, 196 
InitRam, 224 

InitTextPiompt. 128,133-134 
InsertRecord, 379 
InvertLine, 82. 93 
InvertRectangle, 30, 93 
IsMseInRegion, 167, 168 
i-BitmapUp, KX) 
i-FillRam, 223 
uFrameRectangle, 91 
i-GraphicsStrlng, 107 
ùlmpilntRectangle, 95 
UMoveData, 221 
i-PutString, 112, 117 
URecoveiRectangle, 94 
i-Rectangle, 11. 25, 27, 61. 86, 89 
LdApplic. 275, 318 
LdDeskAcc, 246, 271, 275, 324 
LdFUe. 275, 322 
LoadCharSet, 118, 145-147 
MouseOff, 162, 165-166 
MouseUp, 61.162, 165-166 
MoveData, 221, 483 
NewDisk, 61, 275, 317 
NextRecord, 373 
NxtBlkAlloc. 276, 333 
OpenDisk. 274, 281 
OpenFile, 424 
OpenPrint, 426 

OpenRecordFile, 146, 369, 370 
Panie, 220 
PointRecord, 373 
PosSprite, 187, 189 


PreviousRecord, 373 
PrintASCn. 400, 409, 444 
PrintBuffei, 389. 396, 410. 438 
PrintPrintBuffer, 389. 412, 446 
PromptOff, 135 
PromptOn, 128,134 
PurgeTurbo, 277, 354 
PutBlock, 275, 306 
PutChar. 113, 136, 141 
PutDecimal, 119 
PutDirHead. 275, 316, 481 
PutSUing, 112, 117, 120, 125 
ReadBlock, 277, 359 
ReadByte, 105, 275, 313 
ReadFUe, 275, 309 
ReadRecord, 378 
RecoverAUMenus, 14, 44 
RecoverLine, 14, 83 
RecoverMenu, 14, 43 
RecoverRectangle, 14, 75. 94-95. 247 
Rectangle, 11, 80-81, 88-89, 92 
ReDoMenu, 40 
RenameFile, 274, 299 
RestartProcess, 197 
Roll8bytesIn. 453 
Roll8bytesOut, 454 
RoUaCard. 429, 450 
Rotate 422, 459 
RstrAppl, 276, 327 
RstrFrmDialogue, 235-236, 254 
SaveFile, 274. 295. 369 
SendBuff, 419. 466 
SetDevice, 274, 280 
SetGDiiEntry, 276, 339 
SetGEOSDisk, 274, 283 
SetGraphics, 417, 455 
SetNewMode, 480 
SetNextFree, 276, 335 
SetNLQ. 389, 408 
SetPattem, 61. 86, 88 
SlneCosine, 184 
Sleep, 195, 200 

SlowMouse. 151, 153, 155-156, 174 
SmallPutChar, 138 
StartAppl, 276, 350, 461 
StaitASCn. 389-399, 407, 443 
StartMouseMode, 162. 163, 164 
StaitPiint, 387, 395, 405, 436 
StashRAM. 474 
StopPrint. 388, 398, 411, 440 
Strout, 428 
SwapRAM, 476 
TestBuffer. 414, 451 
TestPoint, 79 
ToBasic, 228 

TopRoUBuffer, 429-432, 448 
UnblockProcess, 198 
UnfreezeProcess, 199 
UnSetGraphics, 455 
UpdateMouse, 151, 157-158,175 
UpdateMouseVels, 177 
UpdateMouseX, 180 
UpdateMouseY, 176 
UpdateRecordFile, 372 
UseSystemFont. 118, 145, 148 
VerifyRAM, 477 
VerticalLine, 81 
VerWriteBlock, 277, 363 
WriteBlock, 277, 361 
WriteFile, 275, 311 
WriteRecord, 376 
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Indice delle variabili 

Por argomenti 

Ben di dialogo 

dlgBoxRamBuf, 533 
sysDBData, 245, 254 

Driver di iiqnit 

faultData, 167, 169, 467. 494 
inputData, 154, 159,161, 464 
inputDevName, 154 
inputVectoi, IM, 161 
maxMouseSpeed, 153, 155, 160, 465 
mlnMouseSpeed, 153, 160, 465 
mouseAccel, 153, 155, 161, 465 
mouseBottom, 163, 167, 465 
mouseData, 149-150, 153, 157 
mouseFaultVec, 167, 484 
mouseLeft, 163, 167, 465 
mouseOn, 162,164, 167, 464 
mousePicData, 167, 464-465 
mouseRight, 163, 167, 465 
mouseTop, 163, 167, 465 
mouseVector, 163, 167 
mouseXPos, 5, 37. 149-150, 152-153, 157, 
159-160 464 

mouseYPcffi, 5. 37. 149-150, 152-153, 157, 
159-160, 464 
msePiePtr, 464 
otherPressVec, 5-8, 28 
pressFlag, 149-150, 153-154, 157, 159-160, 
464 

Ejquaniriimi RAM 

lamBase, 534 
ramExpSize, 473 
sysFlgCopy, 17, 19 
sysRAMFlg, 534 

FUeVUR 

curRecord, 370-380 
fìleSize, 528 
fileWritten, 370-371 
\ 2 sedRecords, 370, 371 

Fonti carattere 

bciselìneOffset, 139 
cuiDataPnti, 523 
cuiHeìght, 115-116 
cuiIndexTable, 523 
cuiSetWìdth, 523 
saveFontTab, 531 

GEOS 

alarmSetFlag, 466, 532 
alannTmtVector, 466, 529 
appMaìn, 12-13 
bootName, 17-18, 515 
BRKVector, 220 
dateCopy, 17-18, 515 
fiistBoot, 472 
ìntBotVector, 12 
intTopVector, 12, 466 
nationality, 17-18, 515 
random, 214 
retumAddress, 232-233 
version, 17-18, 515 

Grafica 

curPattem, 88 


dispBufierOn,, 74, 75, 464 
giaphicsMode, 480-481 
recoverVectoi, 75, 247, 467, 484 
screenColors, 532 
vdcCliMode. 534 
wmdowBottom, 127, 464 
windowTop, 127, 464 

Icone e menu 

dblClickCount, 6 
iconSetFlag, 29, 30, 467 
menuNumber. 530 
selectionFlash, 30. 467 

Processi tempoiizzati 

processFlags, 196 

Sistema dei file 

curDevice, 271, 280, 465 
curDirHead, 272. 275, 281, 283 
curDrive, 271, 280, 465, 483 
curType, 534 

dataDiskName, 272, 288, 320 
dataFUeName, 272, 320 
dir2Head, 535 
dirEntryBuf, 272, 290, 293 
diskBlkBuf, 293 
diskOpenFlg, 527 
diiveData, 534 
diiveType, 527 
fileHeader, 272, 290 
fileTrScTab, 272-273 
ìnterleave, 330, 333, 465 
isGEOS, 281 
numDrives, 465 
tuiboFiags, 354, 356 

Testi 

alphaFlag, 135, 467 
cunentMode. 114, 136,140-141, 464 
keyData, 126 
keyVectoi, 5-6, 120, 126 
laslWidth, 115, 137 
leftMargin, 113, 127, 464 
lìghtMargin, 113, 127, 464 
string, 131 

stringFaultVec. 113, 120, 127 
stiingX, 128, 134 
stringY, 128,134 


Alfabetico 

alannSetFlag. 466, 532 
alannTmtVector, 466, 529 
alphaFìag, 135, 467 
appMain, 12-13 
baselineOftset, 139 
bootName, 17-18, 515 
BRKVector, 220 
ciuDataPnti, 523 
cuiDevice, 271, 280, 465 
curDiiHead, 272, 275, 281, 283 
cuiDrive, 271, 280, 465, 483 
curHeight. 115-116 
cuiIndexTable, 523 
cuiPattern, 88 
curRecord, 370-380 
cunentMode, 114, 136, 140-141, 464 
curSetWidth, 523 
cuiType, 534 


dataDiskName, 272, 288, 320 
dataFUeName, 272, 320 
dateCopy, 17-18, 515 
dblClickCount, 6 
dii2Head. 535 
dirEntryBuf, 272, 290, 293 
diskBlkBuf, 293 
diskOpenFlg, 527 
dispBufferOn, 74, 75, 464 
dlgBoxRamBuf, 533 
driveData, 534 
driveType, 527 
faultData. 167, 169, 467, 494 
fileHeader, 272, 290 
fìleSize, 528 
fUeTrScTab, 272-273 
fileWritten. 370-371 
fiistBoot, 472 
graphiesMode, 480-481 
iconSetFlag, 29, 30, 467 
inputData, 154, 159, 161, 464 
inputDevName, 154 
inputVector, 154, 161 
ÌntBotVector, 12 
Ìnterleave, 330, 333, 465 
intTopVector, 12, 466 
isGEOS, 281 
keyData. 126 
keyVectoi, 5-6, 120,126 
lastWidth. 115, 137 
leftMargin, 113, 127, 464 
maxMouseSpeed, 153, 155, 160, 465 
menuNumber, 530 
mlnMouseSpeed, 153, 160, 465 
mouseAccel, 153, 155, 161, 465 
mouseBottom. 163, 167, 465 
mouseData, 149-150,153,157 
mouseFaultVec, 167, 484 
mouseLefe, 163, 167, 465 
mouseOn, 162, 164, 167, 464 
mousePicData, 167, 464-465 
mouseRight, 163, 167, 465 
mouseTop, 163, 167, 465 
mouseVector, 163, 167 
mouseXPos. 5, 37, 149-150, 152-153, 157, 
159-160, 464 

mouseYPos, 5. 37, 149-150, 152-153, 157, 
159-160, 464 
msePicPtr, 464 
nationality, 17-18, 515 
numDrives, 465 
OtherPressVec, 5-8, 28 
pressFlag. 149-150, 153-154, 157, 159-160, 
464 

processFlags, 196 
ramBase, 534 
lamExpSize, 473 
random, 214 

recoverVector, 75, 247. 467, 484 
retumAddress, 232-233 
lìghtMargin, 113, 127, 464 
saveFontTab, 531 
sCTeenColors, 532 
selectionFlash, 30, 467 
string, 131 

StringFaultVec, 113,120,127 
stiingX, 128, 134 
StringY, 128,134 
sysDBData, 245, 254 
sysFlgCopy, 17, 19 
sysRAMFlg, 534 
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tuiboFIags, 354, 356 
usedRecords, 370, 371 
vdcClrMode. 534 
versìon. 17-18, 515 
windowBottom, 127, 464 
windowTop, 127, 464 


Indice analitico 

A 

Alta risoluzione, modo bit-map ad, 14 
AFA (All Points Addressable, punti tutti 
indiiizzabili), 363 
Aree 

di pagina zero, 15-16 
convenzionali, 28 
non convenzionali, 5 
ASCII, stampa in, 383, 388, 389-390 
Assembler, direttive, 21 
AUTO-EXEC, 24. 264, 472 


BAM (Block Availability Map, mappa dei 
blocchi disponibili), 259 
Banchi di memoria, 19-20 
Basic, controllo al, 228 
BIGCOUNT, 98 
Bit-Image Mode, 383 
Bit-map, la grafica in modo, 96 
BIGCOUNT, 98 
Count Byte, 97, 99 
Gruppi grafici compattati, 97 
Mappe grafiche, 97 
Blocchi, distribuzione dei, 259 
Blocco della directory. Directory Block, 260, 
262 

Bold, nero, 141 
Boot Disk. 260 
Box di dialogo 
Box ombra, 236 
Comandi, 239 
DBOPVEC. 242. 244 
DBGETFILES, 241, 245 
DBTXTSTR, 240 
DBUSRICON, 242. 244 
DE-USR-ROUT, 243, 246 
di posizione, 237-238 
Icone, comandi per le, 236-237 
LoadBox, esempio di box di dialogo. 251 
OpenBox, esempio di box di dialogo. 248 
Recupero deirimmagine, 247 
SET-DB-POS, 236-237 
Struttura dei, 236 
Box ombra, box di dialogo, 236 
BSW, la fonte di sistema, 142 
Buffer di schermo, 14. 74-75 
Buffer di stampa, 389 
Buffer utente. 386 
Bus seriale, accesso, 277 
Stampa attraverso il, 385-386 
Byte escape, testo, 113-116 
Byte, GEOS, versione del Kernel, 17-18 

C 

Caratteri 

Clìpping, mascherare i caratteri, 127 
Controllo dello stile, 141 
Corpo dei, 142 
escape per PutChar. 137 


escape per PutString, 115-116 
escape, testo, 113-116 
Fonte carattere, 142 
Gestione dei testi, 125 
Set di, 145-147 
Text wrap, 127 

CARDSWIDE/CARDSDEEP, 390 
Chiamare una routine, 4 
CIA (Communications Interface Adapter), 
defirùzioni, 520 

Clipping, mascherare i caratteri, 127 
Codice dell'applicazione, collocazione in 
memoria. 15 

Codice non strutturato in eventi, 12 
Codice strutturato in eventi, 4-5 
Cold Start, procedura di, 18 
Colore del tratto, 73 
Colore di fondo, 73 
Colori, grafica a, 74 
Compattazione, formati di, 97 
Compilatore, direttive, 21 
Compilazione, 45, 49 
Configure, file, 471-472 
Constraìned, menu di tipo. 36 
Controllo dello stile, 141 
Corpo carattere, sotto-menu dinamici, 142. 
145, 146 

Tavola dei corpi carattere, 144 
Costanti 

Box di dialogo, 504 

Configurazioni dei registri di controllo, 
485 

Costanti generali. 486 
Desk accessory, 324-326, 510 
Directory Header Block. 497 
Disco, 500 
Disco, errori da, 501 
File Entry, 498 
File Header, 498 
File, 500 

File, tipi di, 494-496 
Flag, 494 

GetFile, costanti per, 500 
Grafica, 490 
Icone, 492 
Menu. 38, 486 
Mouse, 490 
Processi, 487 
Tastiera. 489 
Testo, 487 

Tipi dei file GEOS, 494 
Tipi dei file Coirunodore, 496 
Vìe chip. 509 
COUNT. 87 
Count Byte, 97-99 
Cursore, 115-116,123,133-135 

D 

DBGETFILES, 241, 245 
DBOPVEC. 242, 244 
DBTXTSTR, 240 
DBUSRICON, 242, 244 
DB-USR-J^OUT, 243, 246 
Decimali, numeri, PutDecimal, 119 
Desk Accessory, 324-326, 483 
DeskTop, le icone e, 25-27 
Dimensioni geometriche, 74 
Directory Block, blocco della directory, 260, 
262 

Directory Header Block, formato del, 259, 
260, 263 


Directory Header, formato della. 259-262 
Disco virtuale, 24, 472 
Disco, le variabili per l'accesso al. 271-273 
Disk ID. 260 

Disk routine, impiego delle, 273-277, 
vedere anche Sistema dei file 
Doppia pressione del pulsante del mouse, 
5-6 

Driver Commodore 
Driver di stampa, 29 
Jump table residente, 402, 434 
Simboli, definizioni per la stampante, 
402, 433 
Driver di input 

Applicazioni e ClearMouseMode, 162 
Driver per il joystick, blocco File Header, 
170 

Funzionamento del, 149 
Input, cambiamenti dì stato del mouse, 
154-155 

Jump table del, 172 
Locazioni del driver di input, 151 
Regolazione della velocità, 153 
Variabili di gestione del mouse, 160 
Driver dì input standard, 149 
Driver di stampa 
ASCII, stampa, 383, 388, 389-390 
CARDSWIDE/CARDSDEEP. 390 
Jump table del, 402, 434 
Stampa grafica, 383 
Stampanti a 8 punti, 384, 401 
Driver di stampa, definizioni e costanti, 
402, 433 

E 

Escape, carattere di, cambio fonte, 114 
Escape, carattere di, cambio stile, 113-114 
Esecutori, 4 

Esecutori dei processi, 193-195 
Esecuzione delle routine, 10 
Espansione di memoria. 23. 24, 469-473 
Eventi, codice non strutturato in, 12 
Eventi, programmazione a gestione di, 4-5 
Evento, definizione dì, 4, 483 
EXP-BASE, 470 

F 

File Entry, 47, 260, 262-265 
File Header, blocco, 6.47,258,265-270,479, 
562 

Nome permanente, PermanentString, 
266, 269 

ParentApplication, 267, 269 
ParentDisk, 266, 269 
Struttura del. 259, 263 
File QuantumTest, 57 
FileStart, indirizzo di caricamento, 49, 53, 
266, 268 

Font ID, identificatore del set di caratteri, 
fonte carattere, 143 
Fonte carattere. 111, 114, 142-146 
BSW, la fonte di sistema, 142 
Cambiamento di stile nel testo, 113-114, 
141 

Corpo dei caratteri, 142 
di GEOS. 567 

Escape, carattere di, cambio fonte, 114 
Font ID, identificatore del set di caratteri, 
143 

ID, numero d'identificazione unico, fonte 
carattere, 143 
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Identificatole del set di caratteri, Font ID, 
143 

Numero d'identificazione unico. ID, 143 
Set di caratteri, 145-147 
Struttura dei file, 143-145 
Formato PRG, 51-57 

G 

GeoPaint e le icone. 60 
GeoProgrammer, 45 
GEOS 

Buffer di schermo, 14, 75-75 
Caratteristiche di, 3-5 
Chiamata delle routine 
inline, 10-12, 232-233 
pseudoregistri. 10-12 
Doppia pressione del pulsante del mou¬ 
se, 5-6 

Fonti, BSW, 142-145 
Kernel di. 7-12 
Memory Map, 14-16 
Modo bit-map in alta risoluzione, 14 
Programmazione a gestione di eventi, 4-5 
Routine d'inizializzazione, 6 
Routine di recupero delle immagini, 14 
Set di caratteri, 145-147 
Struttura del file, 45-46 
GEOS, Kernel di. 3-4, 7-12 
Codice d'interrupt, 7-10 
Codice non strutturato in eventi, 12 
Configurazione dei registri di controllo, 
20 

Direttive per il compilatore Assembly, 21 
I/O, procedure di. 15-17, 19-20 
InterruptMain. 7-10 
MainLoop, 7-8 
ROM, 19 

Selezione dei banchi, 19-20 
Versione, byte che indicano la, 17-18 
GEOS 128, compatibilità, 23, 479-481 
GEOS V1.3. 23, 469 
GeosConstants, 46 
GeosMacros, 46 
GeosMemoryMap, 46 
GeosRoutines, 46 
geoWrite, 571 
Gestione dei testi, 125 
Gestione delle stringhe, 112-116,120 
Stringhe a terminazione nulla, 112 
Gestione in overlay, 15 
GOTOX. 115-116 
GOTOXY, 115-116 
GOTOY, 115-116 
Grafìca 
Bit-map, 96 

Buffer dì schermo. 14, 74-75 
Colore. 74 

Dimensioni geometriche, 74 
Formati di compattazione, 97 
Linee, disegno delle, 75-77 
Penna, posizione della, 106, 108 
Spazi pieni, disegno degli, 86 
Graphic Environment Operating System, 
Sìstòma Operativo ad Ambiente Grafico, 
vedere GEOS 

Gruppo grafico compattalo, 97 

1 

I/O, gestione del. 15-17, 19-20- 
Icon Editor, 278 
Icon Table, 31 


Icone 

Box di dialogo, comandi per le icone, 236 
Coordinate, 27 
di sistema. 236-238 
e deskTop, 25-27 
e geoPaint, 60 
File QuantumTest, 57 
Fittizia, creazione, 27 
Icon Table, tavole delle, 26, 31 
nel formato dì mappe grafiche, 25-30 
ID, disk. 260 

ID, numero d'identificazione unico, fonte 
carattere, 143 

In-Circuit-Emulator (ICE), unità, 47 

Include, file. 46 

INCOMPATIBLE, 480 

Index Table. 263-264, 367 

Indirizzo d’esecuzione, 49, 53, 266, 268 

Indirizzo di caricamento, 49, 53, 266, 268 

Indirizzo T/S, 258 

InitCode, indirizzo d’esecuzione, 49. 53, 
266, 268 

InitProg, indirizzo d’esecuzione, 49,53,266, 
268 

Inizialìzzazione, routine di, 6 
Inline, chiamata, 10-12, 232-233 
Input, cambiamenti dì stato del mouse. 
154-155 

INPUT-BIT 154-159 
Interrupt, codice di, 7-10 
Interrupt, driver di input. 149-151 
InterruptMain, 7-10 
INV-RECORD, 368 
Italie, corsivo, 141 

J 

Jmp, 12 

Joystick, driver del, blocco File Header, 
170-171 
Joystick 

Driver standard, 149 
Indicatore di posizione sullo schermo, 
149-150 

Pressione e rilascio del pulsante del 
mouse, 149-150 
Vedere anche Driver di input 
Jsr, 11 

Jump table alle routine del driver per il 
mouse. 172 

K 

Kernel 
Esecutori, 4 
Versione, 17-18 

L 

Liberia matematica, 203 
Libreria di routine di utilità generale, 215 
Linea di scansione, 97, 110 
Linee, disegno delle, 75-77 
LoadAddress, indirizzo di caricamento, 49, 
53. 266, 268 

LoadBox, esempio di box di dialogo, 251 

M 

Macro istruzioni, 3. 21. 

MainLoop, 7-8 
Mappa grafica. 96-97 
Mascherare i caratteri, cUpping, 127 
Massimo numero di caratteri in input, 
stringFaultVec, 123, 124 


Master Disk, 260 
Matrice di continuità, 75-76 
Matrice grafica, 75-76, 86-87 
Memory Map, 14-16 
File, 46 

Pagina zero, area di, 15-16 
Pseudoregistri, 10,15 
Menu 

Action, di tipo, 35-38 
Applicazione d'esempio, 57 
Constrained. menu di tipo, 36 
Costanti per i, 38 
File QuantumTest, 57 
Orizzontali, 32, 34-38 
Sotto-menu dinamici. 37-38 
Verticali, 32, 34-38 
Modo 80 colonne, 23, 479-481 
Moduli residenti, file VLIR, 365 
Mouse, 149 
MOUSE-BASE, 151 
MOUSE-BIT, 158-159 
MoveData, opzione, 471 

N 

Near Letter Quality (NLQ), modo, stampan¬ 
ti a matrici di punti, 383, 388-389 
Nome permanente, PermanentString, 266, 
269-270 

O 

Off Page, blocco, 260 

OFF_128_FLAGS, 480 

OpenBox, esempio di un box di dialogo, 248 

OUT_OF_RECORDS, 368 

Overlay, gestione dei moduli in. 15. 365 

P 

Pagina zero. 15-16 
ParentApplication, 267, 269 
ParentDisk, 266, 269 
Pattern, matrice grafica, 86 
Penna, posizione della, 106, 108 
PermanentString, nome permanente, 266, 
269-270 

Photo Scrap, file, 561 
Preference Manager, 73 
PRG, formato 

File Header, blocco, 47, 258, 265-270 
File QuantumTest. 57 
PRGTOGEOS, il programma Basic, 54-56 
TestApplication, 52 

PRGTOGEOS, il programma Basic, 54-56 
Print driver, jump table, 402, 434 
PRINTBASE, 389-391 
Processo temporizzato 
bloccato. 194 
congelato, 194 
Esecutori, 193-195 
eseguibile, 194 
Gestione, 193 

Programmazione a gestione di eventi, 4-5 
Programmazione, procedura consigliata, 13 
Protezione del disco, byte di. 260-262 
Pseudoregistri, 10,15 
Puntatore al record corrente, 367, 373-374 

R 

RAM disk. 24. 472 
RAM Reboot, opzione. 471 
RAM. espansioni, 23, 24, 469-473 
RAM. memory map, 14-16 
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Rboot, file. 471 

Record Indicizzati di Lunghezza Variabile, 
258, 365, vedere anche VLIR 
Record, file VUR, 365 
Registri di controllo, impostazione dei, 20 
Rettangoli, vedere Sf^i pieni 
REU, Ram Expansion Unit, espansione 
RAM. 23. 24, 469^73 
Riga di definizione (ruler), 116, 569 
Riga grafica, 387 
ROM. 19 

Routine d'alto livello, 274, 279 
Routine d'iniziaììzzazione, 6 
Routine di livello intermedio, 275, 303 
Routine di livello primitivo, 276, 351 
Routine di recupero delle immagini, 14 
Routine di servizio, icone, 27 
Routine di servizio, menu, 36-38 
Routine inline, 10-12, 232-233 
Routine, definizioni nella jump table dì 
GEOS. 537 
file include, 46 
Rts, 13 

S 

SEQUENTIAL, file a struttura. 257-258 
SET-DB-POS, 236 
Shadowed Disk, 24, 472 
Sistema dei file, le costanti per accedere al, 
271 

Sistema del file 

BAM, mappa dei blocchi liberi, 259 
Blocchi, distribuzione nelle tracce dei, 
259 

Bus seriale, accesso al, 277 
Costanti. 500 

Directory Block, blocco della directory, 
260, 262 

Directory Header Block. 259-262 
Directory Header, 259-262 
File Entry, 260, 262-265 
File Header. 47. 258. 265-270 
Nome permanente, PermanentString, 
266, 269 

ParentApplication, 267, 269 
ParentDisk, 266, 269 


PermanentString, nome permanente, 
266, 269 

Protezione, byte di, 260-262 
Routine d'alto livello. 274, 279 
Routine di accesso al disco, 273-277 
Routine di livello intermedio, 275, 303 
Routine di livello primitivo, 276, 351 
SEQUENTIAL, file a struttura, 45, 257- 
258 

Struttura del, 257 
TEMPORARY, file di tipo. 263 
Variabili di accesso, 271-273 
VLIR, file a struttura, 258, 365 
Sistema Operativo ad Ambiente Grafico, 
vedere GEOS 
Sotto-menu, 33-38 
Altezza dei, 32 
dinamici, 37-38 
Struttura dei, 34 

Sound Interface Device (SID), definizioni, 
519 

Spazi pieni, il disegno degli, 86 
Matrici grafiche. 75-76, 86-87 
Sprite 

Cursore, 133 
Gestione degli, 187 
Stampa grafica, 383 
Stampanti a 8 punti, 384, 401 
Stampanti, 381-386 
Bus seriale, 385-386 
Interfaccia parallela, 366 
Stampanti a caratteri, 381 
Stampanti a matrice di punti, 381 
Stile 

Bold, nero, 141 
Controllo dello, 141 

Escape, carattere dì, cambio stile, 113- 
114 

Italie, corsivo. 141 
Stringhe a terminazione nulla, 112 
STRUCT-MISMAT. 368 
Swap file, 263, 325 
Switch 40/80, 23. 480 

T 

T/S, indirizzo, 258 


Tavola d'inizializzazione, InitRam, 225 
Tavola indice, VUR. 263-264, 366-367 
TEMPORARY, file di tipo. 263 
TestApplication, 52 
Testo 

Escape, carattere di, cambio fonte, 114 
Input di stringhe, 120 
Massimo numero di caratteri in input, 
stringFaultVec, 123,124 
Text Scrap, file, 561 
Text wrap, 127 

Trasformazione file normali in file GEOS, 
278 

Trucchi di programmazione, 481-484 
U 

UNOPENED-VLIR. 368 
UPLINE, 115 

V 

Variabili, Sistema dei file, 271-273 
di gestione del mouse 
per la programmazione, 160-162 
per le applicazioni, 167-169 
Versione 

Applicazione, 269 
Formato dei file. 268-269 
Kernel, 17-18 

Vie n, chip grafico, definizioni, 517 
VLIR, file a struttura, 15, 45. 258, 310, 365 
Creazione dei, 295, 369 
Messaggi d'errore 
INVAUD-RECORD, 368 
OUT-OFJRECORD. 368 
STRUCT-MISMAT, 368 
UNOPENED_VUR_FILE. 368 
Moduli residenti, file VLIR, 365 
Puntatore al record corrente, 367, 373- 
374 

Swap modules, 263, 325 
Tavola ìndice, 263-264, 366-367 

W 

Warm Start, configurazione di. 461-467 
Word wrap, 127 
Wrap, text, 127 
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il nuovo sistema operativo per i computer 
Commodore 64/64c/128/128D 


I computer a otto bit non saranno mai più gli stessi. 

Scritta dai creatori di GEOS - i programmatori della Berkeley Softworks - la Guida 
ufficiale alla programmazione di GEOS è il testo indispensabile per conoscere a fondo i 
segreti di questo nuovo ambiente operativo e creare stupende applicazioni dotate 
d’interfaccia utente grafica, menu a scomparsa, icone, finestre, box di dialogo, fonti 
proporzionali di ogni corpo e forma, processi eseguibili in multitasking, tempi minimi 
d’accesso al disco, RAM disk, gestione in overlay delle applicazioni, controllo semplifica¬ 
to del mouse, driver di input e di stampa... tutte caratteristiche che fanno di GEOS un 
ambiente di lavoro e sviluppo davvero professionale. 

La guida descrive tutte le routine di sistema (oltre 170), l’intera mappa di memoria, i 
driver di input e di stampa per i dispositivi più comuni, approfondisce tutti gli argomenti 
che si devono conoscere per programmare in ambiente GEOS e svela i trucchi per 
lavorare anche in ambiente GEOS 128. 

In quest’opera si descrivono con ricchezza di particolari tutti gli aspetti di GEOS, senza 
trascurare alcun dettaglio utile per la programmazione. Scopriteli e fate conoscenza con: 

■ La gestione dei flussi di eventi 

■ Le icone e i menu 

■ La grafica, i testi e le fonti carattere 

■ I driver di input e di stampa 

■ I processi temporizzati, le capacità multitasking 

■ I box di dialogo 

■ Il sistema di gestione dei file e il turbo 

■ La libreria matematica 

■ GEOS 128, la grafica a 80 colonne 

■ Le espansioni RAM e il RAM disk 

La Guida ufficiale alla programmazione di GEOS è la più completa fonte d’informazioni 
sul mondo di GEOS. L'edizione italiana è stata redatta apportando al testo originale 
aggiornamenti e correzioni, un lavoro che si è svolto a stretto contatto con i 
programmatori della Berkeley Softworks. 
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